@contentful/experience-design-system-cli 2.37.1-dev-build-f57f8147.0 → 2.37.1-dev-build-20346727.0

package/dist/app.js

@@ -8,71 +8,6 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// packages/experience-design-system-cli/src/tui/package-root.ts
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-function findPackageRoot(startUrl, packageName) {
-  let dir = dirname(fileURLToPath(startUrl));
-  let found;
-  while (true) {
-    const manifestPath = join(dir, "package.json");
-    if (existsSync(manifestPath)) {
-      const pkg = JSON.parse(readFileSync(manifestPath, "utf8"));
-      if (pkg.name === packageName) found = dir;
-    }
-    const parent = dirname(dir);
-    if (parent === dir) return found ?? dir;
-    dir = parent;
-  }
-}
-var init_package_root = __esm({
-  "packages/experience-design-system-cli/src/tui/package-root.ts"() {
-    "use strict";
-  }
-});
-
-// packages/experience-design-system-cli/src/tui/upgrade/version.ts
-import { readFileSync as readFileSync2 } from "node:fs";
-import { join as join2 } from "node:path";
-import semver from "semver";
-function readPackageVersion() {
-  const root = findPackageRoot(import.meta.url, PACKAGE_NAME);
-  const pkg = JSON.parse(readFileSync2(join2(root, "package.json"), "utf8"));
-  return pkg.version ?? "unknown";
-}
-function parseVersionTag(tag) {
-  const match2 = /^v(\d+\.\d+\.\d+)$/.exec(tag);
-  return match2 ? match2[1] : void 0;
-}
-async function checkForUpgrade() {
-  const current = readPackageVersion();
-  try {
-    const response = await fetch(TAGS_URL);
-    if (!response.ok) return { status: "error" };
-    const tags = await response.json();
-    const versions = tags.map((tag) => tag.name ? parseVersionTag(tag.name) : void 0).filter((v) => v !== void 0);
-    if (versions.length === 0) return { status: "error" };
-    const latest = versions.reduce((best, v) => semver.gt(v, best) ? v : best);
-    if (!semver.valid(current)) return { status: "error" };
-    if (semver.gt(latest, current)) {
-      return { status: "update-available", current, latest };
-    }
-    return { status: "up-to-date", current };
-  } catch {
-    return { status: "error" };
-  }
-}
-var PACKAGE_NAME, TAGS_URL;
-var init_version = __esm({
-  "packages/experience-design-system-cli/src/tui/upgrade/version.ts"() {
-    "use strict";
-    init_package_root();
-    PACKAGE_NAME = "@contentful/experience-design-system-cli";
-    TAGS_URL = "https://api.github.com/repos/contentful/experience-design-system-sdk-public/tags?per_page=10";
-  }
-});
-
 // packages/experience-design-system-backend-pipeline/dist/src/agents/types/agent-name.js
 var AGENT_NAMES;
 var init_agent_name = __esm({
@@ -837,7 +772,7 @@ async function runAgent(options) {
     promptLen: prompt.length,
     promptHead: prompt.slice(0, 500)
   });
-  return new Promise((resolve27) => {
+  return new Promise((resolve25) => {
     const bedrockEnv = bedrock ? BEDROCK_ENV_BY_AGENT[agent] : void 0;
     const child = spawn(binary, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -886,7 +821,7 @@ async function runAgent(options) {
         stderrLen: stderr.length,
         stderrTail: stderr.slice(-1e3)
       });
-      resolve27(result);
+      resolve25(result);
     });
   });
 }
@@ -908,7 +843,7 @@ async function checkAgentAuth(agent) {
     return "not-found";
   if (agent !== "claude")
     return "ok";
-  return new Promise((resolve27) => {
+  return new Promise((resolve25) => {
     const child = spawn2(binary, ["auth", "status", "--json"], { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let done = false;
@@ -917,7 +852,7 @@ async function checkAgentAuth(agent) {
         return;
       done = true;
       child.kill("SIGTERM");
-      resolve27("unauthenticated");
+      resolve25("unauthenticated");
     }, 5e3);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
@@ -928,14 +863,14 @@ async function checkAgentAuth(agent) {
       done = true;
       clearTimeout(timer);
       if (code !== 0) {
-        resolve27("unauthenticated");
+        resolve25("unauthenticated");
         return;
       }
       try {
         const status = JSON.parse(stdout);
-        resolve27(status.loggedIn ? "ok" : "unauthenticated");
+        resolve25(status.loggedIn ? "ok" : "unauthenticated");
       } catch {
-        resolve27("unauthenticated");
+        resolve25("unauthenticated");
       }
     });
   });
@@ -945,9 +880,9 @@ async function binaryIsOnPath(binary) {
     const fs = await import("node:fs/promises");
     return fs.access(binary).then(() => true, () => false);
   }
-  return new Promise((resolve27) => {
+  return new Promise((resolve25) => {
     const child = spawn2(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
-    child.on("close", (code) => resolve27(code === 0));
+    child.on("close", (code) => resolve25(code === 0));
   });
 }
 var init_check_agent_auth = __esm({
@@ -2081,256 +2016,9 @@ var init_cache_keys = __esm({
   }
 });
 
-// packages/experience-design-system-types/dist/src/config/index.js
-import { randomBytes as randomBytes3 } from "node:crypto";
-import { mkdir as mkdir6, readFile as readFile18, rename as rename2, writeFile as writeFile6 } from "node:fs/promises";
-import { homedir as homedir3 } from "node:os";
-import { dirname as dirname13, join as join17 } from "node:path";
-function configRoot2() {
-  return process.env["EDS_HOME"] || join17(homedir3(), ".contentful", "experience-design-system-cli");
-}
-async function readSettings2() {
-  try {
-    return JSON.parse(await readFile18(configFilePath2(), "utf8"));
-  } catch {
-    return {};
-  }
-}
-async function writeSettings2(settings) {
-  const path5 = configFilePath2();
-  await mkdir6(dirname13(path5), { recursive: true });
-  const tmp = `${path5}.${process.pid}.${randomBytes3(4).toString("hex")}.tmp`;
-  await writeFile6(tmp, `${JSON.stringify(settings, null, 2)}
-`, { mode: 384 });
-  await rename2(tmp, path5);
-}
-async function updateSettings2(patch) {
-  await writeSettings2({ ...await readSettings2(), ...patch });
-}
-var configFilePath2;
-var init_config = __esm({
-  "packages/experience-design-system-types/dist/src/config/index.js"() {
-    "use strict";
-    configFilePath2 = () => join17(configRoot2(), "config.json");
-  }
-});
-
-// packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts
-async function readDebugModeSetting() {
-  const { debugMode } = await readSettings2();
-  return { ...DEFAULT_DEBUG_MODE_SETTING, ...debugMode };
-}
-async function writeDebugModeSetting(setting) {
-  await updateSettings2({ debugMode: setting });
-}
-var DEFAULT_DEBUG_MODE_SETTING;
-var init_debug_mode_store = __esm({
-  "packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts"() {
-    "use strict";
-    init_config();
-    DEFAULT_DEBUG_MODE_SETTING = {
-      enabled: true
-    };
-  }
-});
-
-// 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 existsSync9, readdirSync as readdirSync4 } from "node:fs";
-import { join as join24, resolve as resolve26 } 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 !== "" ? resolve26(dir) : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function nextSessionId(contentfulDir) {
-  const today = datePrefix();
-  const existing = existsSync9(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 = join24(base, ".contentful");
-  if (replace || !sessionDir) sessionDir = join24(contentfulDir, nextSessionId(contentfulDir));
-  return sessionDir;
-}
-function currentDebugSessionDir() {
-  return sessionDir && join24(sessionDir, "debug");
-}
-function currentSessionDir() {
-  return sessionDir;
-}
-async function startDebugSessionIn(base, { replace = false } = {}) {
-  try {
-    if (!await isDebugModeEnabled()) return;
-    await mkdir9(join24(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
-  } catch {
-  }
-}
-function nextImportRunDir(session) {
-  const existing = existsSync9(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 join24(session, `dsi-import-${maxRun + 1}`);
-}
-async function startImportRun(projectPath) {
-  await startDebugSessionIn(projectPath);
-  if (!sessionDir) return join24(resolve26(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]";
-  }
-  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 = join24(root, ...flowSegments);
-  await mkdir9(dir, { recursive: true });
-  const filename = nextAttemptFilename(dir, run.menuOption);
-  await writeFile8(join24(dir, filename), content, { mode: 384 });
-}
-function nextAttemptFilename(dir, menuOption) {
-  const today = datePrefix();
-  const optionSlug = slugify(menuOption);
-  const existing = existsSync9(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 stepLabel2 = stepMatch ? `${stepMatch[1]} - ${stepMatch[2]}` : run.step;
-  const flowSlug = run.flow.split("/").join("-");
-  return `# Debug Log
-
-- Run ID: ${run.runId}
-- Flow: ${flowSlug}
-- Step: ${stepLabel2}
-- 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;
-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();
-    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(([enabled, base]) => {
-      if (!enabled || !base) return void 0;
-      return mkdir9(join24(startSession(base, { replace: false }), "debug"), { recursive: true });
-    });
-    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/app.tsx
 import { join as join25 } from "node:path";
-import { useEffect as useEffect27, useState as useState33 } from "react";
+import { useEffect as useEffect28, useState as useState33 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -2365,10 +2053,62 @@ function brandBar(width, ramp = BRAND_RAMP) {
     color
   })).filter((segment) => segment.text.length > 0);
 }
-var FOCUS_MARKER = "\u276F";
-
-// packages/experience-design-system-cli/src/tui/home/home.tsx
-init_version();
+var FOCUS_MARKER = "\u276F";
+
+// packages/experience-design-system-cli/src/tui/upgrade/version.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { join as join2 } from "node:path";
+import semver from "semver";
+
+// packages/experience-design-system-cli/src/tui/package-root.ts
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function findPackageRoot(startUrl, packageName) {
+  let dir = dirname(fileURLToPath(startUrl));
+  let found;
+  while (true) {
+    const manifestPath = join(dir, "package.json");
+    if (existsSync(manifestPath)) {
+      const pkg = JSON.parse(readFileSync(manifestPath, "utf8"));
+      if (pkg.name === packageName) found = dir;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return found ?? dir;
+    dir = parent;
+  }
+}
+
+// packages/experience-design-system-cli/src/tui/upgrade/version.ts
+var PACKAGE_NAME = "@contentful/experience-design-system-cli";
+var TAGS_URL = "https://api.github.com/repos/contentful/experience-design-system-sdk-public/tags?per_page=10";
+function readPackageVersion() {
+  const root = findPackageRoot(import.meta.url, PACKAGE_NAME);
+  const pkg = JSON.parse(readFileSync2(join2(root, "package.json"), "utf8"));
+  return pkg.version ?? "unknown";
+}
+function parseVersionTag(tag) {
+  const match2 = /^v(\d+\.\d+\.\d+)$/.exec(tag);
+  return match2 ? match2[1] : void 0;
+}
+async function checkForUpgrade() {
+  const current = readPackageVersion();
+  try {
+    const response = await fetch(TAGS_URL);
+    if (!response.ok) return { status: "error" };
+    const tags = await response.json();
+    const versions = tags.map((tag) => tag.name ? parseVersionTag(tag.name) : void 0).filter((v) => v !== void 0);
+    if (versions.length === 0) return { status: "error" };
+    const latest = versions.reduce((best, v) => semver.gt(v, best) ? v : best);
+    if (!semver.valid(current)) return { status: "error" };
+    if (semver.gt(latest, current)) {
+      return { status: "update-available", current, latest };
+    }
+    return { status: "up-to-date", current };
+  } catch {
+    return { status: "error" };
+  }
+}
 
 // packages/experience-design-system-cli/src/tui/use-terminal-width.ts
 import { useEffect, useState } from "react";
@@ -2500,9 +2240,14 @@ function HomeScreen({ onNavigate }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/PageContainer.tsx
-import { Box as Box2, Text as Text3, useInput as useInput2 } from "ink";
+import { useEffect as useEffect3 } from "react";
+import { Box as Box2, Text as Text3, useInput as useInput2, useStdout as useStdout2 } from "ink";
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 function ImportScreen({ exitCode, onDone }) {
+  const { stdout } = useStdout2();
+  useEffect3(() => {
+    stdout.write("\x1B[H\x1B[0J");
+  }, [stdout]);
   useInput2((input, key) => {
     if (key.return || key.escape || input === "q") {
       onDone();
@@ -2710,7 +2455,7 @@ function TokenInputScreen({ onConfirm, onBack, initialPath = "" }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/screen.tsx
-import { useEffect as useEffect3, useMemo, useState as useState5 } from "react";
+import { useEffect as useEffect4, useMemo, useState as useState5 } from "react";
 import { Box as Box5, Text as Text6 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/controls.ts
@@ -12567,11 +12312,11 @@ import { access as access2, mkdir, readFile as readFile7, writeFile } from "node
 // packages/experience-design-system-backend-pipeline/dist/src/persistence/src/review-session/repositories/review-session-paths.js
 import { resolve as resolve15 } from "node:path";
 async function getRefineSessionPaths(sessionId, artifactsRoot) {
-  const sessionDir2 = resolve15(artifactsRoot, sessionId);
+  const sessionDir = resolve15(artifactsRoot, sessionId);
   return {
-    sessionDir: sessionDir2,
-    eventsPath: resolve15(sessionDir2, "events.jsonl"),
-    statePath: resolve15(sessionDir2, "current-review-state.json")
+    sessionDir,
+    eventsPath: resolve15(sessionDir, "events.jsonl"),
+    statePath: resolve15(sessionDir, "current-review-state.json")
   };
 }
 
@@ -13770,7 +13515,7 @@ function errorMessage(error) {
   return error instanceof Error && error.message ? error.message : String(error);
 }
 function defaultSleep(delayMs) {
-  return new Promise((resolve27) => setTimeout(resolve27, delayMs));
+  return new Promise((resolve25) => setTimeout(resolve25, delayMs));
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/steps/apply/src/helpers/sanitize-preview.js
@@ -14011,7 +13756,7 @@ var ApiClient = class {
         const progress = maxAttempts > 1 ? attempt / (maxAttempts - 1) : 0;
         const baseDelay = intervalMs + (maxIntervalMs - intervalMs) * progress;
         const jitter = Math.random() * baseDelay * 0.15;
-        await new Promise((resolve27) => setTimeout(resolve27, baseDelay + jitter));
+        await new Promise((resolve25) => setTimeout(resolve25, baseDelay + jitter));
       }
     }
     throw new Error(`Operation ${operationId} timed out after ${maxAttempts} attempts`);
@@ -16124,7 +15869,7 @@ async function retryDatabaseWrite(operation, attempts = 8) {
       const message = error instanceof Error ? error.message : String(error);
       if (!/database is locked|database is busy/i.test(message) || attempt >= attempts)
         throw error;
-      await new Promise((resolve27) => setTimeout(resolve27, Math.min(250 * attempt, 2e3)));
+      await new Promise((resolve25) => setTimeout(resolve25, Math.min(250 * attempt, 2e3)));
     }
   }
 }
@@ -16871,7 +16616,7 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState5();
-  useEffect3(() => {
+  useEffect4(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
@@ -16951,7 +16696,6 @@ function useCredentialsControls(handlers) {
 }
 
 // packages/experience-design-system-cli/src/tui/user-agent.ts
-init_version();
 function cliUserAgent() {
   return buildUserAgent(readPackageVersion());
 }
@@ -17240,10 +16984,10 @@ var PROGRESS_THEME = extendTheme(defaultTheme, {
 });
 
 // packages/experience-design-system-cli/src/tui/import/shared/running-step/use-elapsed.ts
-import { useEffect as useEffect4, useState as useState7 } from "react";
+import { useEffect as useEffect5, useState as useState7 } from "react";
 function useElapsed() {
   const [seconds, setSeconds] = useState7(0);
-  useEffect4(() => {
+  useEffect5(() => {
     const timer = setInterval(() => setSeconds((current) => current + 1), 1e3);
     return () => clearInterval(timer);
   }, []);
@@ -17296,34 +17040,11 @@ function RunningStep({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/05-token-reuse/logic.ts
-import { access as access5, readdir as readdir2, stat as stat4 } from "node:fs/promises";
+import { access as access5, stat as stat4 } from "node:fs/promises";
 import { join as join16 } from "node:path";
-async function findLatestTokens(contentfulDir) {
-  const candidates = [join16(contentfulDir, "tokens.json")];
-  try {
-    for (const session of await readdir2(contentfulDir, { withFileTypes: true })) {
-      if (!session.isDirectory()) continue;
-      for (const run of await readdir2(join16(contentfulDir, session.name), { withFileTypes: true }).catch(() => [])) {
-        if (run.isDirectory() && /^dsi-import-\d+$/.test(run.name)) {
-          candidates.push(join16(contentfulDir, session.name, run.name, "tokens.json"));
-        }
-      }
-    }
-  } catch {
-  }
-  const found = [];
-  for (const path5 of candidates) {
-    try {
-      found.push({ path: path5, mtimeMs: (await stat4(path5)).mtimeMs });
-    } catch {
-    }
-  }
-  return found.sort((a, b) => b.mtimeMs - a.mtimeMs)[0]?.path ?? null;
-}
-async function inspectTokens({ rawTokensPath, contentfulDir, cache }) {
+async function inspectTokens({ rawTokensPath, outDir, cache }) {
   if (!cache) return { kind: "none" };
-  const tokensPath = await findLatestTokens(contentfulDir);
-  if (!tokensPath) return { kind: "none" };
+  const tokensPath = join16(outDir, "tokens.json");
   try {
     await access5(tokensPath);
   } catch {
@@ -17474,11 +17195,37 @@ function ExtractionScreen({
   );
 }
 
-// packages/experience-design-system-cli/app.tsx
-init_config();
+// packages/experience-design-system-types/dist/src/config/index.js
+import { randomBytes as randomBytes3 } from "node:crypto";
+import { mkdir as mkdir6, readFile as readFile18, rename as rename2, writeFile as writeFile6 } from "node:fs/promises";
+import { homedir as homedir3 } from "node:os";
+import { dirname as dirname13, join as join17 } from "node:path";
+function configRoot2() {
+  return process.env["EDS_HOME"] || join17(homedir3(), ".contentful", "experience-design-system-cli");
+}
+var configFilePath2 = () => join17(configRoot2(), "config.json");
+var debugSessionsDir2 = () => join17(configRoot2(), "debug", "sessions");
+async function readSettings2() {
+  try {
+    return JSON.parse(await readFile18(configFilePath2(), "utf8"));
+  } catch {
+    return {};
+  }
+}
+async function writeSettings2(settings) {
+  const path5 = configFilePath2();
+  await mkdir6(dirname13(path5), { recursive: true });
+  const tmp = `${path5}.${process.pid}.${randomBytes3(4).toString("hex")}.tmp`;
+  await writeFile6(tmp, `${JSON.stringify(settings, null, 2)}
+`, { mode: 384 });
+  await rename2(tmp, path5);
+}
+async function updateSettings2(patch) {
+  await writeSettings2({ ...await readSettings2(), ...patch });
+}
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/use-extraction.ts
-import { useEffect as useEffect5, useRef as useRef2, useState as useState8 } from "react";
+import { useEffect as useEffect6, useRef as useRef2, useState as useState8 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/06-extraction/run.ts
 import { mkdir as mkdir7 } from "node:fs/promises";
@@ -17602,7 +17349,7 @@ var realDeps = {
 var fail = (step, message) => ({ ok: false, step, message });
 var errorMessage2 = (error) => error instanceof Error ? error.message : String(error);
 async function runExtraction(input, onProgress, deps = realDeps) {
-  const outDir = input.outDir ?? join19(resolve22(input.projectPath), ".contentful");
+  const outDir = join19(resolve22(input.projectPath), ".contentful");
   let progress = initialProgress({
     hasCredentials: input.credentials !== null,
     hasRawTokens: input.rawTokensPath !== "",
@@ -17737,7 +17484,7 @@ async function resolveSelectionPrompt(overrides) {
 function useExtraction(input) {
   const [state, setState] = useState8();
   const current = useRef2();
-  useEffect5(() => {
+  useEffect6(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -17767,7 +17514,7 @@ function useExtraction(input) {
 import { Box as Box20, Text as Text22 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/panels/added-column.tsx
-import React6 from "react";
+import React7 from "react";
 import { Box as Box11, Text as Text12 } from "ink";
 import figures from "figures";
 
@@ -17968,7 +17715,7 @@ function AddedColumn(props) {
       const aiFlagged = aiFlaggedByKey?.get(entry.name) === true;
       const showSeparator = firstNonCycleIdx > 0 && i === firstNonCycleIdx;
       const style = sideColumnLabelStyle({ isCycle: entry.isCycle, isSelected, focused });
-      return /* @__PURE__ */ jsxs11(React6.Fragment, { children: [
+      return /* @__PURE__ */ jsxs11(React7.Fragment, { children: [
         showSeparator && /* @__PURE__ */ jsx14(Text12, { dimColor: true, children: "\u2500".repeat(Math.max(0, width - 2)) }),
         /* @__PURE__ */ jsxs11(Box11, { children: [
           isCursor ? /* @__PURE__ */ jsx14(Text12, { color: PALETTE2.info, bold: true, children: figures.pointer }) : /* @__PURE__ */ jsx14(Text12, { children: " " }),
@@ -19001,7 +18748,7 @@ function GroupedSidebar(props) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/sidebar/components/HelpOverlay.tsx
-import React7 from "react";
+import React8 from "react";
 import { Box as Box18, Text as Text20 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/sidebar/hooks/useImmediateInput.ts
@@ -19078,8 +18825,8 @@ function useImmediateInput(handler, enabled = true) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/sidebar/hooks/use-terminal-size.ts
-import { useStdout as useStdout2 } from "ink";
-import { useEffect as useEffect6, useState as useState9 } from "react";
+import { useStdout as useStdout3 } from "ink";
+import { useEffect as useEffect7, useState as useState9 } from "react";
 function readTerminalSize(stdout) {
   return {
     columns: stdout?.columns ?? 80,
@@ -19087,9 +18834,9 @@ function readTerminalSize(stdout) {
   };
 }
 function useTerminalSize() {
-  const { stdout } = useStdout2();
+  const { stdout } = useStdout3();
   const [size, setSize] = useState9(() => readTerminalSize(stdout));
-  useEffect6(() => {
+  useEffect7(() => {
     const updateSize = () => setSize(readTerminalSize(stdout));
     stdout?.on("resize", updateSize);
     updateSize();
@@ -19123,7 +18870,7 @@ function HelpOverlay(props) {
         overflowY: "hidden",
         children: [
           /* @__PURE__ */ jsx22(Text20, { bold: true, children: "\u2500".repeat(titleRule) + " Help " + "\u2500".repeat(titleRule) }),
-          props.sections.map((section) => /* @__PURE__ */ jsxs19(React7.Fragment, { children: [
+          props.sections.map((section) => /* @__PURE__ */ jsxs19(React8.Fragment, { children: [
             /* @__PURE__ */ jsx22(Text20, { children: " " }),
             /* @__PURE__ */ jsx22(Text20, { bold: true, children: section.title }),
             section.entries.map((entry) => /* @__PURE__ */ jsx22(Text20, { children: entry.keys ? "  " + entry.keys.padEnd(16) + " " + entry.label : "  " + entry.label }, entry.keys + entry.label))
@@ -19272,7 +19019,7 @@ function createSidebarViewsHelpSection(includeBreaking) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate.ts
-import { useEffect as useEffect7, useMemo as useMemo2, useRef as useRef4, useState as useState12 } from "react";
+import { useEffect as useEffect8, useMemo as useMemo2, useRef as useRef4, useState as useState12 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/graph/search-neighborhood.ts
 function computeDirectNeighborhood(matches, graph) {
@@ -19956,7 +19703,7 @@ function useScopeGate({ components, onConfirm, onQuit }) {
     return seed;
   });
   const seededGroupsRef = useRef4(closures.size > 0 || cycleParticipants.size > 0);
-  useEffect7(() => {
+  useEffect8(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && cycleParticipants.size === 0) return;
     seededGroupsRef.current = true;
@@ -20046,7 +19793,7 @@ function useScopeGate({ components, onConfirm, onQuit }) {
     entryCount: 0
   });
   const panelLayout = useMemo2(() => computePanelLayout(visibleCount), [visibleCount]);
-  useEffect7(() => {
+  useEffect8(() => {
     setNav((prev) => {
       const maxIdx = Math.max(0, visibleRows.length - 1);
       const nextCursor = Math.min(prev.cursor, maxIdx);
@@ -20514,7 +20261,7 @@ function ScopeGateView({ components, onConfirm, onQuit }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/use-scope-gate-flow.ts
-import { useEffect as useEffect8, useMemo as useMemo3, useRef as useRef5, useState as useState13 } from "react";
+import { useEffect as useEffect9, useMemo as useMemo3, useRef as useRef5, useState as useState13 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/cache-check.ts
 async function checkGenerationCache(input) {
@@ -20563,7 +20310,7 @@ function useScopeGateFlow(input, deps = realDeps2) {
   const loaded = useMemo3(() => sessionId ? deps.load(sessionId) : void 0, [sessionId]);
   const cacheCheck = useRef5(void 0);
   const [confirmed, setConfirmed] = useState13();
-  useEffect8(() => {
+  useEffect9(() => {
     if (!input || !loaded?.ok || cacheCheck.current) return;
     cacheCheck.current = deps.checkCache(input.cache);
   }, [input, loaded]);
@@ -20634,7 +20381,7 @@ function GenerationScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/use-generation.ts
-import { useEffect as useEffect9, useRef as useRef6, useState as useState14 } from "react";
+import { useEffect as useEffect10, useRef as useRef6, useState as useState14 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/run.ts
 import { resolve as resolve23 } from "node:path";
@@ -20800,7 +20547,7 @@ function applyProgressEvent2(event, previous, total) {
 function useGeneration(input) {
   const [state, setState] = useState14();
   const current = useRef6();
-  useEffect9(() => {
+  useEffect10(() => {
     current.current = input;
     if (!input) {
       setState(void 0);
@@ -20846,7 +20593,7 @@ function buildFlowStart(input) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/screen.tsx
-import { useEffect as useEffect20, useRef as useRef12 } from "react";
+import { useEffect as useEffect21, useRef as useRef12 } from "react";
 import { Box as Box41 } from "ink";
 
 // packages/experience-design-system-types/dist/src/cdf/validate.js
@@ -21193,7 +20940,7 @@ function PreviewValidationErrorScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/generate-review-step.tsx
-import { useCallback as useCallback5, useEffect as useEffect16, useMemo as useMemo4, useRef as useRef11, useState as useState22 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect17, useMemo as useMemo4, useRef as useRef11, useState as useState22 } from "react";
 import figures7 from "figures";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/theme.ts
@@ -21465,7 +21212,7 @@ function enumerateCycleBreaks(cycle, components) {
 import { Box as Box27, Text as Text30 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/components/FieldEditor.tsx
-import React8, { useEffect as useEffect10, useLayoutEffect as useLayoutEffect2, useState as useState15 } from "react";
+import React9, { useEffect as useEffect11, useLayoutEffect as useLayoutEffect2, useState as useState15 } from "react";
 import figures5 from "figures";
 import { Box as Box21, measureElement, Text as Text23 } from "ink";
 
@@ -22176,9 +21923,9 @@ function FieldEditor({
   const [editorState, setEditorState] = useState15(initialState);
   const [parseErr] = useState15(parseError);
   const [listScrollStart, setListScrollStart] = useState15(0);
-  const initialFocusScrollApplied = React8.useRef(false);
+  const initialFocusScrollApplied = React9.useRef(false);
   const [rowHeights, setRowHeights] = useState15({});
-  const rowMeasureRefs = React8.useRef(/* @__PURE__ */ new Map());
+  const rowMeasureRefs = React9.useRef(/* @__PURE__ */ new Map());
   const initialFocus = (() => {
     if (initialFocusTarget?.kind === "description") {
       return {
@@ -22265,23 +22012,23 @@ function FieldEditor({
   const [showHelp, setShowHelp] = useState15(false);
   const props = editorState.props;
   const slots = editorState.slots;
-  const contentPropIndexes = React8.useMemo(
+  const contentPropIndexes = React9.useMemo(
     () => props.flatMap((prop, index) => prop.category === "content" ? [index] : []),
     [props]
   );
-  const designPropIndexes = React8.useMemo(
+  const designPropIndexes = React9.useMemo(
     () => props.flatMap((prop, index) => prop.category === "design" ? [index] : []),
     [props]
   );
-  const hiddenPropIndexes = React8.useMemo(
+  const hiddenPropIndexes = React9.useMemo(
     () => showHiddenProps ? props.flatMap((prop, index) => prop.category === "state" || prop.category === "unattached" ? [index] : []) : [],
     [props, showHiddenProps]
   );
-  const visiblePropIndexes = React8.useMemo(
+  const visiblePropIndexes = React9.useMemo(
     () => [...contentPropIndexes, ...designPropIndexes, ...hiddenPropIndexes],
     [contentPropIndexes, designPropIndexes, hiddenPropIndexes]
   );
-  const propGroups = React8.useMemo(
+  const propGroups = React9.useMemo(
     () => [
       {
         kind: "content",
@@ -22301,7 +22048,7 @@ function FieldEditor({
     ],
     [contentPropIndexes, designPropIndexes, hiddenPropIndexes]
   );
-  const selectableRows = React8.useMemo(
+  const selectableRows = React9.useMemo(
     () => [
       ...contentPropIndexes.map((idx) => ({ kind: "prop", idx })),
       ...designPropIndexes.map((idx) => ({ kind: "prop", idx })),
@@ -22311,7 +22058,7 @@ function FieldEditor({
     [contentPropIndexes, designPropIndexes, hiddenPropIndexes, slots]
   );
   const visiblePropPosition = visiblePropIndexes.indexOf(propIdx);
-  const selectedSelectableIndex = React8.useMemo(
+  const selectedSelectableIndex = React9.useMemo(
     () => selectableRows.findIndex(
       (row) => inSlots ? row.kind === "slot" && row.idx === slotIdx : row.kind === "prop" && row.idx === propIdx
     ),
@@ -22330,12 +22077,12 @@ function FieldEditor({
     }
   };
   const textEntryActive = focusLevel === "field" && editingField && activeField === "description" || focusLevel === "field" && editingField && activeField === "default" && (editorState.props[propIdx]?.type === "string" || editorState.props[propIdx]?.type === "token") || editingValue != null;
-  React8.useEffect(() => {
+  React9.useEffect(() => {
     onTextEntryActiveChange?.(textEntryActive);
   }, [textEntryActive, onTextEntryActiveChange]);
   const currentProp = props[propIdx] ?? null;
   const currentSlot = slots[slotIdx] ?? null;
-  React8.useEffect(() => {
+  React9.useEffect(() => {
     if (showHiddenProps || inSlots || inComponentDesc || visiblePropPosition >= 0) return;
     if (visiblePropIndexes.length > 0) {
       setPropIdx(visiblePropIndexes[0]);
@@ -22354,22 +22101,22 @@ function FieldEditor({
     setEditorState(next);
     onChange(serializeState(next, value));
   };
-  const canonicalize = React8.useCallback((json) => {
+  const canonicalize = React9.useCallback((json) => {
     try {
       return JSON.stringify(JSON.parse(json));
     } catch {
       return `__unparseable__:${json}`;
     }
   }, []);
-  const initialStateRef = React8.useRef(initialState);
+  const initialStateRef = React9.useRef(initialState);
   const baselineCanonical = canonicalize(serializeState(initialStateRef.current, value));
   const currentCanonical = canonicalize(serializeState(editorState, value));
   const isDirty = currentCanonical !== baselineCanonical;
-  React8.useEffect(() => {
+  React9.useEffect(() => {
     onDirtyChange?.(isDirty);
   }, [isDirty, onDirtyChange]);
-  const lastDiscardTriggerRef = React8.useRef(discardTrigger);
-  React8.useEffect(() => {
+  const lastDiscardTriggerRef = React9.useRef(discardTrigger);
+  React9.useEffect(() => {
     if (discardTrigger === void 0) return;
     if (discardTrigger === lastDiscardTriggerRef.current) return;
     lastDiscardTriggerRef.current = discardTrigger;
@@ -22968,7 +22715,7 @@ function FieldEditor({
     }
     return Math.max(start + 1, end2);
   };
-  useEffect10(() => {
+  useEffect11(() => {
     if (focusLevel === "field" || selectedRowIdx < 0) return;
     setListScrollStart((previous) => {
       if (initialFocusTarget && !initialFocusScrollApplied.current) {
@@ -24026,7 +23773,7 @@ function finalizeReviewSession(extractSessionId, components) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-session.ts
-import { useCallback as useCallback2, useEffect as useEffect12, useRef as useRef8, useState as useState17 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect13, useRef as useRef8, useState as useState17 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/history.ts
 var DEFAULT_MAX_DEPTH = 50;
@@ -24082,7 +23829,7 @@ function createHistoryStack(seed, maxDepth = DEFAULT_MAX_DEPTH) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-finalize-preview.ts
-import { useEffect as useEffect11, useRef as useRef7, useState as useState16 } from "react";
+import { useEffect as useEffect12, useRef as useRef7, useState as useState16 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/run-live-preview.ts
 var TimeoutError = class extends Error {
@@ -24234,7 +23981,7 @@ function useFinalizePreview(opts) {
   const [scrollOffset, setScrollOffset] = useState16(0);
   const generationRef = useRef7(0);
   const acceptedKey = [...acceptedKeys].sort().join("\0");
-  useEffect11(() => {
+  useEffect12(() => {
     if (!open) {
       setStatus("idle");
       setRemoved([]);
@@ -24297,7 +24044,7 @@ function useReviewSession({
     }));
     return { result, catalog };
   }, [loadSession, tokensPath]);
-  useEffect12(() => {
+  useEffect13(() => {
     let disposed = false;
     void (async () => {
       try {
@@ -24350,7 +24097,7 @@ function useReviewSession({
 function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   const [reviewMetadata, setReviewMetadata] = useState17(null);
   const [componentRationale, setComponentRationale] = useState17(null);
-  useEffect12(() => {
+  useEffect13(() => {
     const current = components[selectedIdx];
     if (!current) {
       setReviewMetadata(null);
@@ -24382,7 +24129,7 @@ function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
 function useReviewHistory({ loading, components, createSnapshot, applySnapshot }) {
   const historyRef = useRef8(null);
   const historySeededRef = useRef8(false);
-  useEffect12(() => {
+  useEffect13(() => {
     if (loading || historySeededRef.current) return;
     historySeededRef.current = true;
     historyRef.current = createHistoryStack(createSnapshot(components));
@@ -24433,7 +24180,7 @@ function useReviewFinalize({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-editor.ts
-import { useEffect as useEffect13, useRef as useRef9, useState as useState18 } from "react";
+import { useEffect as useEffect14, useRef as useRef9, useState as useState18 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/token-suggestions.ts
 function collectTokenSuggestions(entry, availableTokens = []) {
@@ -24486,7 +24233,7 @@ function useReviewEditor({
   const [tokenReviewEditSelection, setTokenReviewEditSelection] = useState18(/* @__PURE__ */ new Set());
   const tokenReviewSuggestedRef = useRef9(/* @__PURE__ */ new Map());
   const pendingGRef = useRef9(false);
-  useEffect13(() => {
+  useEffect14(() => {
     setTokenReviewRow(0);
     setTokenReviewEditing(false);
     setTokenReviewEditCursor(0);
@@ -24890,7 +24637,7 @@ function handleJsonPanelInput(input, key, state) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-preview.ts
-import { useCallback as useCallback4, useEffect as useEffect15, useState as useState21 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect16, useState as useState21 } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/preview-annotations.ts
 function applyPreviewAnnotations(preview, localNames) {
@@ -24925,7 +24672,7 @@ function applyPreviewAnnotations(preview, localNames) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/use-live-preview.ts
-import { useCallback as useCallback3, useEffect as useEffect14, useRef as useRef10, useState as useState20 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect15, useRef as useRef10, useState as useState20 } from "react";
 var DEFAULT_DEBOUNCE_MS = 500;
 function useLivePreview(opts) {
   const debounceMs = opts.debounceMs ?? DEFAULT_DEBOUNCE_MS;
@@ -24936,14 +24683,14 @@ function useLivePreview(opts) {
   const latestRef = useRef10(0);
   const inflightRef = useRef10(0);
   const optsRef = useRef10(opts);
-  useEffect14(() => {
+  useEffect15(() => {
     optsRef.current = opts;
   });
   const disabledRef = useRef10(disabled);
-  useEffect14(() => {
+  useEffect15(() => {
     disabledRef.current = disabled;
   }, [disabled]);
-  useEffect14(() => {
+  useEffect15(() => {
     return () => {
       if (timerRef.current) {
         clearTimeout(timerRef.current);
@@ -25057,13 +24804,13 @@ function useReviewPreview({
     deleteAllComponents
   });
   const [spinnerTick, setSpinnerTick] = useState21(0);
-  useEffect15(() => {
+  useEffect16(() => {
     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];
-  useEffect15(() => {
+  useEffect16(() => {
     if (loading) return;
     if (!livePreview) return;
     if (components.length === 0) return;
@@ -25483,7 +25230,7 @@ function GenerateReviewStepView({
     [components]
   );
   const closures = useMemo4(() => computeAllClosures(componentGraph), [componentGraph]);
-  useEffect16(() => {
+  useEffect17(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && slotCycles.length === 0) return;
     seededGroupsRef.current = true;
@@ -25510,7 +25257,7 @@ function GenerateReviewStepView({
       suggestedBreak: cycle.edges.length > 0 ? suggestCycleBreakEdge2(cycle, cycleView.pushBlocking) : null
     }));
   }, [slotCycles, cycleView]);
-  useEffect16(() => {
+  useEffect17(() => {
     const decision = computeAutoRejectDecision({
       loading,
       autoRejectFired: autoRejectFiredRef.current,
@@ -25554,7 +25301,7 @@ function GenerateReviewStepView({
     applySnapshot: applyHistorySnapshot
   });
   const autoRejectPushedRef = useRef11(false);
-  useEffect16(() => {
+  useEffect17(() => {
     if (loading) return;
     if (!historySeededRef.current) return;
     if (!autoRejectFiredRef.current) return;
@@ -25638,7 +25385,7 @@ function GenerateReviewStepView({
   const panelHeight = leftPanelHeight + 2;
   const panelContentHeight = Math.max(1, panelHeight - 3);
   const cycleViewportHeight = Math.max(1, panelHeight - 4);
-  useEffect16(() => {
+  useEffect17(() => {
     if (selectableRowPositions.length === 0) return;
     const cursorInRange = selectableRowPositions.includes(cursorRowIdx);
     const maxScroll = Math.max(0, visibleRowsMemo.length - visibleCount);
@@ -26598,10 +26345,10 @@ function normalizePath(input) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-blinking-cursor.ts
-import { useEffect as useEffect17, useState as useState23 } from "react";
+import { useEffect as useEffect18, useState as useState23 } from "react";
 function useBlinkingCursor() {
   const [visible, setVisible] = useState23(true);
-  useEffect17(() => {
+  useEffect18(() => {
     const interval = setInterval(() => setVisible((current) => !current), 500);
     return () => clearInterval(interval);
   }, []);
@@ -26709,12 +26456,12 @@ function StepHeader({ stepNumber, totalSteps, title }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-timed-spinner.tsx
-import { useEffect as useEffect18, useState as useState25 } from "react";
+import { useEffect as useEffect19, useState as useState25 } from "react";
 import { Spinner as Spinner2 } from "@inkjs/ui";
 import { jsx as jsx49 } from "react/jsx-runtime";
 function useTimedSpinner() {
   const [elapsedSeconds, setElapsedSeconds] = useState25(0);
-  useEffect18(() => {
+  useEffect19(() => {
     const timer = setInterval(() => setElapsedSeconds((current) => current + 1), 1e3);
     return () => {
       clearInterval(timer);
@@ -26763,7 +26510,7 @@ function PushingStep({ stepNumber, totalSteps, progress }) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/screens/WizardPreviewStep.tsx
-import { useEffect as useEffect19, useState as useState26, useMemo as useMemo5 } from "react";
+import { useEffect as useEffect20, useState as useState26, useMemo as useMemo5 } from "react";
 import { Box as Box40, Text as Text43 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/preview-diff.ts
@@ -27148,7 +26895,7 @@ function WizardPreviewStep({
   const activeLines = diffExpanded ? diffLines : summaryLines;
   const maxScroll = Math.max(0, activeLines.length - viewportHeight);
   const boundedScrollOffset = Math.min(scrollOffset, maxScroll);
-  useEffect19(() => {
+  useEffect20(() => {
     setScrollOffset((previous) => Math.min(previous, maxScroll));
   }, [maxScroll]);
   useImmediateInput((input, key) => {
@@ -27253,7 +27000,7 @@ function FlowScreen({
   const totalSteps = totalStepsFor(state);
   const quit = () => onExit(0);
   const previousStep = useRef12(state.step);
-  useEffect20(() => {
+  useEffect21(() => {
     if (previousStep.current !== state.step) {
       onStepChange?.();
       previousStep.current = state.step;
@@ -27384,13 +27131,13 @@ function FlowScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-import { useEffect as useEffect21, useRef as useRef13, useSyncExternalStore } from "react";
+import { useEffect as useEffect22, useRef as useRef13, useSyncExternalStore } from "react";
 
 // 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 { tmpdir } from "node:os";
-import { join as join23, resolve as resolve25 } from "node:path";
+import { join as join23 } from "node:path";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/wizard-state-transitions.ts
 function shouldBypassPreview(state) {
@@ -27761,7 +27508,7 @@ var realSaveDeps = () => ({
   writeFile: (path5, contents) => writeFile7(path5, contents),
   appendRun,
   buildSourceFingerprint,
-  sleep: (ms) => new Promise((resolve27) => setTimeout(resolve27, ms)),
+  sleep: (ms) => new Promise((resolve25) => setTimeout(resolve25, ms)),
   warn: (message) => process.stderr.write(message)
 });
 async function runPrintFiles(input, deps, onPatch) {
@@ -28089,7 +27836,7 @@ function createFlowController(start, deps) {
     },
     async submitPath(submitted) {
       await deps.mkdir(submitted);
-      if (resolve25(submitted) !== resolve25(state.outDir) && await deps.detectSaveConflict(submitted)) {
+      if (await deps.detectSaveConflict(submitted)) {
         const subdir = deps.buildTimestampedSubdir(submitted);
         await deps.mkdir(subdir);
         await proceedToWrite(subdir);
@@ -28125,28 +27872,180 @@ function useFlow(start, deps = realFlowDeps) {
     (listener) => current?.subscribe(listener) ?? (() => void 0),
     () => current?.getState()
   );
-  useEffect21(() => {
+  useEffect22(() => {
     if (!start) controller.current = void 0;
   }, [start]);
   return current && state ? { controller: current, state } : void 0;
 }
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect22, useState as useState27 } from "react";
+import { useEffect as useEffect23, useState as useState27 } from "react";
 import { Box as Box42, Text as Text44, useInput as useInput9 } from "ink";
-init_debug_store();
+
+// packages/experience-design-system-cli/src/tui/debug-store.ts
+import { mkdir as mkdir9, writeFile as writeFile8 } from "node:fs/promises";
+import { existsSync as existsSync9, readdirSync as readdirSync4 } from "node:fs";
+import { join as join24 } from "node:path";
+
+// packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts
+var DEFAULT_DEBUG_MODE_SETTING = {
+  enabled: true
+};
+async function readDebugModeSetting() {
+  const { debugMode } = await readSettings2();
+  return { ...DEFAULT_DEBUG_MODE_SETTING, ...debugMode };
+}
+async function writeDebugModeSetting(setting) {
+  await updateSettings2({ debugMode: setting });
+}
+
+// packages/experience-design-system-cli/src/tui/debug-store.ts
+var pendingRun;
+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, "");
+}
+function generateSessionId3() {
+  const today = datePrefix();
+  const root = debugSessionsDir2();
+  const existing = existsSync9(root) ? readdirSync4(root) : [];
+  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}`;
+}
+var SESSION_ID = generateSessionId3();
+function sessionDebugDir() {
+  return join24(debugSessionsDir2(), SESSION_ID);
+}
+function currentDebugSessionDir() {
+  return sessionDebugDir();
+}
+void isDebugModeEnabled().then((enabled) => {
+  if (!enabled) return void 0;
+  return mkdir9(sessionDebugDir(), { recursive: true });
+});
+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 content = renderMarkdown(run, { outputs: redact(outputs), status, exitMethod, durationMs });
+  const flowSegments = run.flow.split("/");
+  const dir = join24(sessionDebugDir(), ...flowSegments);
+  await mkdir9(dir, { recursive: true });
+  const filename = nextAttemptFilename(dir, run.menuOption);
+  await writeFile8(join24(dir, filename), content, { mode: 384 });
+}
+function nextAttemptFilename(dir, menuOption) {
+  const today = datePrefix();
+  const optionSlug = slugify(menuOption);
+  const existing = existsSync9(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 stepLabel2 = stepMatch ? `${stepMatch[1]} - ${stepMatch[2]}` : run.step;
+  const flowSlug = run.flow.split("/").join("-");
+  return `# Debug Log
+
+- Run ID: ${run.runId}
+- Flow: ${flowSlug}
+- Step: ${stepLabel2}
+- 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" });
+}
+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/help/help-info.ts
-init_config();
-init_debug_store();
-init_debug_mode_store();
-init_version();
 async function readHelpInfo() {
   const debugMode = await readDebugModeSetting();
   return {
     storage: [
       { label: "Config folder", value: configRoot2() },
-      { label: "Settings file", value: configFilePath2() }
+      { label: "Settings file", value: configFilePath2() },
+      { label: "Debug logs", value: debugSessionsDir2() }
     ],
     troubleshooting: [
       { label: "CLI version", value: readPackageVersion() },
@@ -28155,7 +28054,7 @@ async function readHelpInfo() {
       { label: "Debug Mode", value: debugMode.enabled ? "on" : "off" },
       {
         label: "This session",
-        value: !debugMode.enabled ? "no logs written while Debug Mode is off" : currentDebugSessionDir() ?? "not started: set the Root Project Directory in Settings, or start an import"
+        value: debugMode.enabled ? currentDebugSessionDir() : "no logs written while Debug Mode is off"
       }
     ]
   };
@@ -28174,7 +28073,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState27();
-  useEffect22(() => {
+  useEffect23(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -28267,12 +28166,11 @@ function SettingsScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { useEffect as useEffect23, useState as useState29 } from "react";
+import { useEffect as useEffect24, useState as useState29 } from "react";
 import { Box as Box44, Text as Text46, useInput as useInput11 } from "ink";
 import TextInput4 from "ink-text-input";
 
 // packages/experience-design-system-cli/src/tui/settings/utils/v1-store.ts
-init_config();
 var readV1Store = readSettings2;
 var writeV1Store = writeSettings2;
 
@@ -28285,8 +28183,7 @@ async function readCredentials() {
     cmaToken: store.cmaToken || "",
     host: store.host || "",
     defaultComponentDir: store.defaultComponentDir || "",
-    defaultTokenFile: store.defaultTokenFile || "",
-    contentfulBaseDir: store.contentfulBaseDir || ""
+    defaultTokenFile: store.defaultTokenFile || ""
   };
 }
 async function writeCredentials(config) {
@@ -28302,7 +28199,6 @@ async function writeCredentials(config) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-init_debug_store();
 import { Fragment as Fragment17, jsx as jsx55, jsxs as jsxs45 } from "react/jsx-runtime";
 var FIELD_ORDER = [
   "spaceId",
@@ -28310,8 +28206,7 @@ var FIELD_ORDER = [
   "cmaToken",
   "host",
   "defaultComponentDir",
-  "defaultTokenFile",
-  "contentfulBaseDir"
+  "defaultTokenFile"
 ];
 function debugFields(config) {
   return {
@@ -28320,23 +28215,17 @@ function debugFields(config) {
     cma_token: config?.cmaToken ?? "",
     host: config?.host ?? "",
     default_component_dir: config?.defaultComponentDir ?? "",
-    default_token_file: config?.defaultTokenFile ?? "",
-    contentful_base_dir: config?.contentfulBaseDir ?? ""
+    default_token_file: config?.defaultTokenFile ?? ""
   };
 }
 var FIELD_LABELS = {
   spaceId: "Space ID",
   environmentId: "Environment ID",
   cmaToken: "CMA Token",
-  host: "API Host",
-  defaultComponentDir: "Default component directory",
-  defaultTokenFile: "Default token file",
-  contentfulBaseDir: "Root Project Directory"
+  host: "API Host (optional)",
+  defaultComponentDir: "Default component directory (optional)",
+  defaultTokenFile: "Default token file (optional)"
 };
-var FIELD_HINTS = {
-  contentfulBaseDir: "(where .contentful goes)"
-};
-var LABEL_WIDTH = Math.max(...Object.values(FIELD_LABELS).map((label) => label.length));
 function ConfigurationScreen({ onDone }) {
   const [stage, setStage] = useState29("loading");
   const [config, setConfig] = useState29(null);
@@ -28345,7 +28234,7 @@ function ConfigurationScreen({ onDone }) {
   const [lastSaved, setLastSaved] = useState29(null);
   const [editing, setEditing] = useState29(false);
   const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
-  useEffect23(() => {
+  useEffect24(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       setStage("form");
@@ -28372,7 +28261,6 @@ function ConfigurationScreen({ onDone }) {
     setNotice(null);
     writeCredentials(config).then(() => {
       setLastSaved(config);
-      if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
       setNotice({ kind: "success", text: "Configuration saved" });
       setStage("form");
     }).catch((err) => {
@@ -28438,7 +28326,10 @@ function ConfigurationScreen({ onDone }) {
       const display = field === "cmaToken" ? "\u2022".repeat(value.length) : value;
       return /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
         /* @__PURE__ */ jsx55(Text46, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
-        /* @__PURE__ */ jsx55(Box44, { width: LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: FIELD_LABELS[field] }) }),
+        /* @__PURE__ */ jsxs45(Text46, { bold: isActive, children: [
+          FIELD_LABELS[field],
+          ":"
+        ] }),
         isActive && editing ? /* @__PURE__ */ jsx55(
           TextInput4,
           {
@@ -28447,8 +28338,7 @@ function ConfigurationScreen({ onDone }) {
             onSubmit: () => setEditing(false),
             mask: field === "cmaToken" ? "\u2022" : void 0
           }
-        ) : /* @__PURE__ */ jsx55(Text46, { bold: !!display, children: display || (FIELD_HINTS[field] ? "" : /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" })) }),
-        FIELD_HINTS[field] && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: FIELD_HINTS[field] })
+        ) : /* @__PURE__ */ jsx55(Text46, { children: display || /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" }) })
       ] }, field);
     }) }),
     notice && /* @__PURE__ */ jsxs45(Fragment17, { children: [
@@ -28481,7 +28371,7 @@ function ConfigurationScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect24, useState as useState30 } from "react";
+import { useEffect as useEffect25, useState as useState30 } from "react";
 import { Box as Box45, Text as Text47, useInput as useInput12 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
@@ -28500,12 +28390,11 @@ async function writeAnalyticsSetting(setting) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-init_debug_store();
 import { Fragment as Fragment18, jsx as jsx56, jsxs as jsxs46 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState30(true);
   const [enabled, setEnabled] = useState30(true);
-  useEffect24(() => {
+  useEffect25(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28559,15 +28448,13 @@ function OptInAnalyticsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect25, useState as useState31 } from "react";
+import { useEffect as useEffect26, useState as useState31 } from "react";
 import { Box as Box46, Text as Text48, useInput as useInput13 } from "ink";
-init_version();
-init_debug_store();
 import { jsx as jsx57, jsxs as jsxs47 } from "react/jsx-runtime";
 var UPGRADE_COMMANDS = ["git pull", "pnpm install", "pnpm build"];
 function UpgradeScreen({ onDone }) {
   const [upgradeCheck, setUpgradeCheck] = useState31();
-  useEffect25(() => {
+  useEffect26(() => {
     startDebugRun({
       flow: "upgrade",
       step: "01-upgrade",
@@ -28632,15 +28519,13 @@ function renderBody(upgradeCheck) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect26, useState as useState32 } from "react";
+import { useEffect as useEffect27, useState as useState32 } from "react";
 import { Box as Box47, Text as Text49, useInput as useInput14 } from "ink";
-init_debug_mode_store();
-init_debug_store();
 import { jsx as jsx58, jsxs as jsxs48 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
   const [loading, setLoading] = useState32(true);
   const [enabled, setEnabled] = useState32(true);
-  useEffect26(() => {
+  useEffect27(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28720,7 +28605,7 @@ function App({ importOptions, inkClear }) {
   const [flowStart, setFlowStart] = useState33();
   const flow = useFlow(flowStart);
   const [importDefaults, setImportDefaults] = useState33();
-  useEffect27(() => {
+  useEffect28(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -28738,7 +28623,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state = await inspectTokens({
       rawTokensPath: tokens,
-      contentfulDir: join25(resolveUserPath(projectPath2), ".contentful"),
+      outDir: join25(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state.kind === "cached") {
@@ -28759,7 +28644,6 @@ function App({ importOptions, inkClear }) {
     const settings = await readSettings2();
     const { agent, agentModel } = resolveAgentChoice(launch.agent, settings);
     const generatePromptPath = typeof settings.generatePromptPath === "string" ? settings.generatePromptPath : void 0;
-    const outDir = await (await Promise.resolve().then(() => (init_debug_store(), debug_store_exports))).startImportRun(resolveUserPath(launch.projectPath ?? ""));
     setExtractionRun({
       ...generatePromptPath ? { generatePromptPath } : {},
       // the later steps get the same agent, so they use what the stage used
@@ -28768,7 +28652,6 @@ function App({ importOptions, inkClear }) {
       tokenStrategy,
       input: {
         projectPath: resolveUserPath(launch.projectPath ?? ""),
-        outDir,
         filePaths: launch.filePaths ?? [],
         rawTokensPath: launch.tokens ?? "",
         tokenStrategy,
@@ -28780,12 +28663,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect27(() => {
+  useEffect28(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect27(() => {
+  useEffect28(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -28803,7 +28686,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect27(() => {
+  useEffect28(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();