@contentful/experience-design-system-cli 2.39.1-dev-build-cac1a211.0 → 2.39.1-dev-build-4580d8be.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;
@@ -20092,7 +20439,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 +20448,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 +20680,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 useEffect5, 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 +20736,7 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState7();
-  useEffect4(() => {
+  useEffect5(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
@@ -20686,7 +21033,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 useRef3, 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 +21043,7 @@ function CredentialsScreen({
   validate: validate3 = validateCredentials,
   tokensOnly = false
 }) {
-  const initialValues = useRef2(
+  const initialValues = useRef3(
     normalize({
       spaceId: initial.spaceId ?? "",
       environmentId: initial.environmentId || "master",
@@ -21144,16 +21491,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 +21514,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 +21610,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 +21717,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 +21737,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 +21763,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 useEffect6, useRef as useRef4, useState as useState11 } from "react";
 function useExtraction(input) {
   const [state2, setState] = useState11();
-  const current = useRef3();
-  useEffect5(() => {
+  const current = useRef4();
+  useEffect6(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -21491,11 +21838,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 useEffect7, useRef as useRef5, useState as useState12 } from "react";
 function useTokensOnly(input) {
   const [state2, setState] = useState12();
-  const current = useRef4();
-  useEffect6(() => {
+  const current = useRef5();
+  useEffect7(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -22319,11 +22666,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;
     };
@@ -22443,11 +22790,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;
     };
@@ -22692,7 +23039,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 useRef6 } from "react";
 import { useStdin } from "ink";
 function parseInput(data) {
   const isShiftTab = data === "\x1B[Z";
@@ -22754,7 +23101,7 @@ function registerInputHandler(stdin, setRawMode, handler) {
 }
 function useImmediateInput(handler, enabled = true) {
   const { stdin, setRawMode } = useStdin();
-  const handlerRef = useRef5(handler);
+  const handlerRef = useRef6(handler);
   handlerRef.current = handler;
   useLayoutEffect(() => {
     if (!enabled) return;
@@ -22772,7 +23119,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 useEffect8, useState as useState13 } from "react";
 function readTerminalSize(stdout) {
   return {
     columns: stdout?.columns ?? 80,
@@ -22782,7 +23129,7 @@ function readTerminalSize(stdout) {
 function useTerminalSize() {
   const { stdout } = useStdout2();
   const [size, setSize] = useState13(() => readTerminalSize(stdout));
-  useEffect7(() => {
+  useEffect8(() => {
     const updateSize = () => setSize(readTerminalSize(stdout));
     stdout?.on("resize", updateSize);
     updateSize();
@@ -23784,7 +24131,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 useEffect9, useMemo as useMemo3, useRef as useRef7, useState as useState16 } from "react";
 function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }) {
   const { columns: totalWidth, rows: terminalRows } = useTerminalSize();
   const columnPlan = useMemo3(
@@ -23830,8 +24177,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 = useRef7(closures.size > 0 || cycleParticipants.size > 0);
+  useEffect9(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && cycleParticipants.size === 0) return;
     seededGroupsRef.current = true;
@@ -23922,7 +24269,7 @@ function useScopeGate({ components, tokenCount, tokensWidth, onConfirm, onQuit }
     entryCount: 0
   });
   const panelLayout = useMemo3(() => computePanelLayout(visibleCount), [visibleCount]);
-  useEffect8(() => {
+  useEffect9(() => {
     setNav((prev) => {
       const maxIdx = Math.max(0, visibleRows.length - 1);
       const nextCursor = Math.min(prev.cursor, maxIdx);
@@ -24495,13 +24842,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 useEffect10, useMemo as useMemo5, useRef as useRef8, 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 = useRef8(void 0);
   const [confirmed, setConfirmed] = useState17();
-  useEffect9(() => {
+  useEffect10(() => {
     if (!input || !loaded?.ok || cacheCheck.current) return;
     cacheCheck.current = deps.checkCache(input.cache);
   }, [input, loaded]);
@@ -24639,7 +24986,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) => {
@@ -24725,7 +25072,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 });
@@ -24772,11 +25119,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 useEffect11, useRef as useRef9, useState as useState18 } from "react";
 function useGeneration(input) {
   const [state2, setState] = useState18();
-  const current = useRef8();
-  useEffect10(() => {
+  const current = useRef9();
+  useEffect11(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -24803,7 +25150,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 ?? {
@@ -24816,7 +25163,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,
@@ -25204,12 +25551,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();
   }
 });
 
@@ -25349,14 +25825,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];
@@ -25364,7 +25840,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,
@@ -25634,7 +26110,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 useEffect12, 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";
@@ -27161,7 +27637,7 @@ function FieldEditor({
     }
     return Math.max(start + 1, end2);
   };
-  useEffect11(() => {
+  useEffect12(() => {
     if (focusLevel === "field" || selectedRowIdx < 0) return;
     setListScrollStart((previous) => {
       if (initialFocusTarget && !initialFocusScrollApplied.current) {
@@ -28556,7 +29032,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 useEffect13, useRef as useRef10, useState as useState20 } from "react";
 function useReviewFinalizePreview({
   components,
   ...options
@@ -28571,9 +29047,9 @@ function useFinalizePreview(opts) {
   const [status, setStatus] = useState20("idle");
   const [removed, setRemoved] = useState20([]);
   const [scrollOffset, setScrollOffset] = useState20(0);
-  const generationRef = useRef9(0);
+  const generationRef = useRef10(0);
   const acceptedKey = [...acceptedKeys].sort().join("\0");
-  useEffect12(() => {
+  useEffect13(() => {
     if (!open) {
       setStatus("idle");
       setRemoved([]);
@@ -28625,7 +29101,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 useEffect14, useRef as useRef11, useState as useState21 } from "react";
 function useReviewSession({
   loadSession,
   tokensPath,
@@ -28644,7 +29120,7 @@ function useReviewSession({
     }));
     return { result, catalog };
   }, [loadSession, tokensPath]);
-  useEffect13(() => {
+  useEffect14(() => {
     let disposed = false;
     void (async () => {
       try {
@@ -28697,7 +29173,7 @@ function useReviewSession({
 function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   const [reviewMetadata, setReviewMetadata] = useState21(null);
   const [componentRationale, setComponentRationale] = useState21(null);
-  useEffect13(() => {
+  useEffect14(() => {
     const current = components[selectedIdx];
     if (!current) {
       setReviewMetadata(null);
@@ -28727,9 +29203,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 = useRef11(null);
+  const historySeededRef = useRef11(false);
+  useEffect14(() => {
     if (loading || historySeededRef.current) return;
     historySeededRef.current = true;
     historyRef.current = createHistoryStack(createSnapshot(components));
@@ -28811,7 +29287,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 useEffect15, useRef as useRef12, useState as useState22 } from "react";
 function parseReviewEntry(draftValue) {
   const parsed = JSON.parse(draftValue);
   const keys = Object.keys(parsed);
@@ -28843,9 +29319,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 = useRef12(/* @__PURE__ */ new Map());
+  const pendingGRef = useRef12(false);
+  useEffect15(() => {
     setTokenReviewRow(0);
     setTokenReviewEditing(false);
     setTokenReviewEditCursor(0);
@@ -29327,24 +29803,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 useEffect16, useRef as useRef13, 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 = useRef13(null);
+  const generationRef = useRef13(0);
+  const latestRef = useRef13(0);
+  const inflightRef = useRef13(0);
+  const optsRef = useRef13(opts);
+  useEffect16(() => {
     optsRef.current = opts;
   });
-  const disabledRef = useRef12(disabled);
-  useEffect15(() => {
+  const disabledRef = useRef13(disabled);
+  useEffect16(() => {
     disabledRef.current = disabled;
   }, [disabled]);
-  useEffect15(() => {
+  useEffect16(() => {
     return () => {
       if (timerRef.current) {
         clearTimeout(timerRef.current);
@@ -29425,7 +29901,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 useEffect17, useState as useState25 } from "react";
 function useReviewPreview({
   components,
   loading,
@@ -29467,13 +29943,13 @@ function useReviewPreview({
     deleteAllComponents
   });
   const [spinnerTick, setSpinnerTick] = useState25(0);
-  useEffect16(() => {
+  useEffect17(() => {
     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(() => {
+  useEffect17(() => {
     if (loading) return;
     if (!livePreview) return;
     if (components.length === 0) return;
@@ -29530,7 +30006,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 useEffect18, useMemo as useMemo6, useRef as useRef14, 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";
@@ -29744,7 +30220,7 @@ function GenerateReviewStepView({
     setFinalizeError
   } = reviewSurface;
   const [removedBannerCollapsed, setRemovedBannerCollapsed] = useState26(false);
-  const removedBannerDefaultedRef = useRef13(false);
+  const removedBannerDefaultedRef = useRef14(false);
   const [cyclePanelScroll, setCyclePanelScroll] = useState26(0);
   const [cyclesCursor, setCyclesCursor] = useState26(0);
   const cyclePanel = useOverlayPanel({
@@ -29764,7 +30240,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 = useRef14(false);
   const {
     searchOpen,
     setSearchOpen,
@@ -29788,7 +30264,7 @@ function GenerateReviewStepView({
   const [pendingEditorFocus, setPendingEditorFocus] = useState26(null);
   const [autoRejected, setAutoRejected] = useState26([]);
   const [undoSnapshot, setUndoSnapshot] = useState26(null);
-  const autoRejectFiredRef = useRef13(false);
+  const autoRejectFiredRef = useRef14(false);
   const [showReloadDialog, setShowReloadDialog] = useState26(false);
   const acceptedCountForPreview = components.filter((c2) => c2.status === "accepted").length;
   const { previewAnnotations, removedComponents, livePreviewHook, livePreviewSpinner } = useReviewPreview({
@@ -29851,7 +30327,7 @@ function GenerateReviewStepView({
     [components]
   );
   const closures = useMemo6(() => computeAllClosures(componentGraph), [componentGraph]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && slotCycles.length === 0) return;
     seededGroupsRef.current = true;
@@ -29878,7 +30354,7 @@ function GenerateReviewStepView({
       suggestedBreak: cycle.edges.length > 0 ? suggestCycleBreakEdge2(cycle, cycleView.pushBlocking) : null
     }));
   }, [slotCycles, cycleView]);
-  useEffect17(() => {
+  useEffect18(() => {
     const decision = computeAutoRejectDecision({
       loading,
       autoRejectFired: autoRejectFiredRef.current,
@@ -29921,8 +30397,8 @@ function GenerateReviewStepView({
     }),
     applySnapshot: applyHistorySnapshot
   });
-  const autoRejectPushedRef = useRef13(false);
-  useEffect17(() => {
+  const autoRejectPushedRef = useRef14(false);
+  useEffect18(() => {
     if (loading) return;
     if (!historySeededRef.current) return;
     if (!autoRejectFiredRef.current) return;
@@ -30006,7 +30482,7 @@ function GenerateReviewStepView({
   const panelHeight = leftPanelHeight + 2;
   const panelContentHeight = Math.max(1, panelHeight - 3);
   const cycleViewportHeight = Math.max(1, panelHeight - 4);
-  useEffect17(() => {
+  useEffect18(() => {
     if (selectableRowPositions.length === 0) return;
     const cursorInRange = selectableRowPositions.includes(cursorRowIdx);
     const maxScroll = Math.max(0, visibleRowsMemo.length - visibleCount);
@@ -31065,7 +31541,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("~\\")) {
@@ -31079,7 +31555,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"() {
@@ -31088,10 +31564,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 useEffect19, useState as useState27 } from "react";
 function useBlinkingCursor() {
   const [visible, setVisible] = useState27(true);
-  useEffect18(() => {
+  useEffect19(() => {
     const interval = setInterval(() => setVisible((current) => !current), 500);
     return () => clearInterval(interval);
   }, []);
@@ -31106,29 +31582,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,
@@ -31228,12 +31704,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 useEffect20, 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(() => {
+  useEffect20(() => {
     const timer = setInterval(() => setElapsedSeconds((current) => current + 1), 1e3);
     return () => {
       clearInterval(timer);
@@ -31502,7 +31978,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 useEffect21, 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) {
@@ -31712,7 +32188,7 @@ function WizardPreviewStep({
   const activeLines = diffExpanded ? diffLines : summaryLines;
   const maxScroll = Math.max(0, activeLines.length - viewportHeight);
   const boundedScrollOffset = Math.min(scrollOffset, maxScroll);
-  useEffect20(() => {
+  useEffect21(() => {
     setScrollOffset((previous) => Math.min(previous, maxScroll));
   }, [maxScroll]);
   useImmediateInput((input, key) => {
@@ -32348,8 +32824,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");
@@ -32361,7 +32837,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 = [];
@@ -32445,7 +32921,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)),
@@ -32468,9 +32944,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");
 }
@@ -32493,7 +32969,7 @@ function realFlowDeps() {
       }
     },
     mkdir: async (path5) => {
-      await mkdir8(path5, { recursive: true });
+      await mkdir9(path5, { recursive: true });
     },
     detectSaveConflict,
     buildTimestampedSubdir,
@@ -32723,367 +33199,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 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 useEffect22, useRef as useRef15, useSyncExternalStore } from "react";
+function useFlow(start, options = {}) {
+  const controller = useRef15();
+  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()
+  );
+  useEffect22(() => {
+    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();
   }
 });
 
@@ -33154,7 +33334,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 useEffect23, 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 }) {
@@ -33168,7 +33348,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState31();
-  useEffect22(() => {
+  useEffect23(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -33589,7 +33769,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 useEffect24, 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() {
@@ -33610,7 +33790,7 @@ function AgentDetail({
   const [testing, setTesting] = useState33(false);
   const [notice, setNotice] = useState33(null);
   const [checks, setChecks] = useState33(void 0);
-  useEffect23(() => {
+  useEffect24(() => {
     let active = true;
     setChecks(void 0);
     const timer = setTimeout(() => {
@@ -33702,7 +33882,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 useEffect25, useRef as useRef16, 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 }) {
@@ -33713,7 +33893,7 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState34(false);
   const [loadError, setLoadError] = useState34(null);
   const [checks, setChecks] = useState34({});
-  const visit = useRef15({
+  const visit = useRef16({
     trail: createTrail(),
     before: void 0,
     environment: void 0,
@@ -33726,7 +33906,7 @@ function AgentsScreen({ onDone }) {
       );
     }
   };
-  useEffect24(() => {
+  useEffect25(() => {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
@@ -33952,7 +34132,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 useEffect26, useRef as useRef17, 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) {
@@ -33971,14 +34151,14 @@ function ProjectScreen({ onDone }) {
   const [saving, setSaving] = useState35(false);
   const [notice, setNotice] = useState35(null);
   const [loadError, setLoadError] = useState35(null);
-  const visit = useRef16({
+  const visit = useRef17({
     trail: createTrail(),
     before: void 0,
     persisted: void 0,
     error: ""
   }).current;
   const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
-  useEffect25(() => {
+  useEffect26(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       visit.before = snapshotOf(cfg);
@@ -34165,13 +34345,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 useEffect27, 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(() => {
+  useEffect27(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -34234,7 +34414,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 useEffect28, useRef as useRef18, 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 }) {
@@ -34244,8 +34424,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 = useRef18({ trail: createTrail(), before: void 0, error: "" }).current;
+  useEffect28(() => {
     readDebugModeSetting().then((loaded) => {
       setSetting(loaded);
       setPending(loaded.retentionDays);
@@ -34386,7 +34566,7 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { useEffect as useEffect28, useState as useState39 } from "react";
+import { useEffect as useEffect29, 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");
@@ -34420,7 +34600,7 @@ function App({ importOptions, inkClear }) {
   const [flowStart, setFlowStart] = useState39();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState39();
-  useEffect28(() => {
+  useEffect29(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -34493,7 +34673,7 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect28(() => {
+  useEffect29(() => {
     if (!tokensOnlyRun || tokensOnly?.status !== "done" || !tokensOnly.result.ok) return;
     const { credentialsSkipped, input, tokens } = tokensOnlyRun;
     const { tokensPath, tokenSessionId, tokenCount } = tokensOnly.result;
@@ -34515,12 +34695,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   }, [tokensOnly, tokensOnlyRun]);
-  useEffect28(() => {
+  useEffect29(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect28(() => {
+  useEffect29(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -34538,7 +34718,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect28(() => {
+  useEffect29(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();