@contentful/experience-design-system-cli 2.37.1-dev-build-2fb4dadf.0 → 2.37.1-dev-build-36f90a5a.0

package/dist/app.js

@@ -8,6 +8,71 @@ 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({
@@ -772,7 +837,7 @@ async function runAgent(options) {
     promptLen: prompt.length,
     promptHead: prompt.slice(0, 500)
   });
-  return new Promise((resolve25) => {
+  return new Promise((resolve26) => {
     const bedrockEnv = bedrock ? BEDROCK_ENV_BY_AGENT[agent] : void 0;
     const child = spawn(binary, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -821,7 +886,7 @@ async function runAgent(options) {
         stderrLen: stderr.length,
         stderrTail: stderr.slice(-1e3)
       });
-      resolve25(result);
+      resolve26(result);
     });
   });
 }
@@ -843,7 +908,7 @@ async function checkAgentAuth(agent) {
     return "not-found";
   if (agent !== "claude")
     return "ok";
-  return new Promise((resolve25) => {
+  return new Promise((resolve26) => {
     const child = spawn2(binary, ["auth", "status", "--json"], { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let done = false;
@@ -852,7 +917,7 @@ async function checkAgentAuth(agent) {
         return;
       done = true;
       child.kill("SIGTERM");
-      resolve25("unauthenticated");
+      resolve26("unauthenticated");
     }, 5e3);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
@@ -863,14 +928,14 @@ async function checkAgentAuth(agent) {
       done = true;
       clearTimeout(timer);
       if (code !== 0) {
-        resolve25("unauthenticated");
+        resolve26("unauthenticated");
         return;
       }
       try {
         const status = JSON.parse(stdout);
-        resolve25(status.loggedIn ? "ok" : "unauthenticated");
+        resolve26(status.loggedIn ? "ok" : "unauthenticated");
       } catch {
-        resolve25("unauthenticated");
+        resolve26("unauthenticated");
       }
     });
   });
@@ -880,9 +945,9 @@ async function binaryIsOnPath(binary) {
     const fs = await import("node:fs/promises");
     return fs.access(binary).then(() => true, () => false);
   }
-  return new Promise((resolve25) => {
+  return new Promise((resolve26) => {
     const child = spawn2(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
-    child.on("close", (code) => resolve25(code === 0));
+    child.on("close", (code) => resolve26(code === 0));
   });
 }
 var init_check_agent_auth = __esm({
@@ -2016,6 +2081,233 @@ 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,
+  finishDebugRun: () => finishDebugRun,
+  startDebugRun: () => startDebugRun,
+  startDebugSessionIn: () => startDebugSessionIn
+});
+import { mkdir as mkdir8, writeFile as writeFile7 } from "node:fs/promises";
+import { existsSync as existsSync9, readdirSync as readdirSync3 } from "node:fs";
+import { join as join20, resolve as resolve23 } 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 !== "" ? resolve23(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) {
+  const contentfulDir = join20(base, ".contentful");
+  sessionDir ??= join20(contentfulDir, nextSessionId(contentfulDir));
+  return sessionDir;
+}
+function currentDebugSessionDir() {
+  return sessionDir && join20(sessionDir, "debug");
+}
+async function startDebugSessionIn(base) {
+  try {
+    if (!await isDebugModeEnabled()) return;
+    await mkdir8(join20(startSession(resolve23(base)), "debug"), { recursive: true });
+  } catch {
+  }
+}
+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 = join20(root, ...flowSegments);
+  await mkdir8(dir, { recursive: true });
+  const filename = nextAttemptFilename(dir, run.menuOption);
+  await writeFile7(join20(dir, filename), content, { mode: 384 });
+}
+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 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 mkdir8(join20(startSession(base), "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";
@@ -2055,60 +2347,8 @@ function brandBar(width, ramp = BRAND_RAMP) {
 }
 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/home/home.tsx
+init_version();
 
 // packages/experience-design-system-cli/src/tui/use-terminal-width.ts
 import { useEffect, useState } from "react";
@@ -12307,11 +12547,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 sessionDir = resolve15(artifactsRoot, sessionId);
+  const sessionDir2 = resolve15(artifactsRoot, sessionId);
   return {
-    sessionDir,
-    eventsPath: resolve15(sessionDir, "events.jsonl"),
-    statePath: resolve15(sessionDir, "current-review-state.json")
+    sessionDir: sessionDir2,
+    eventsPath: resolve15(sessionDir2, "events.jsonl"),
+    statePath: resolve15(sessionDir2, "current-review-state.json")
   };
 }
 
@@ -13510,7 +13750,7 @@ function errorMessage(error) {
   return error instanceof Error && error.message ? error.message : String(error);
 }
 function defaultSleep(delayMs) {
-  return new Promise((resolve25) => setTimeout(resolve25, delayMs));
+  return new Promise((resolve26) => setTimeout(resolve26, delayMs));
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/steps/apply/src/helpers/sanitize-preview.js
@@ -13751,7 +13991,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((resolve25) => setTimeout(resolve25, baseDelay + jitter));
+        await new Promise((resolve26) => setTimeout(resolve26, baseDelay + jitter));
       }
     }
     throw new Error(`Operation ${operationId} timed out after ${maxAttempts} attempts`);
@@ -15864,7 +16104,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((resolve25) => setTimeout(resolve25, Math.min(250 * attempt, 2e3)));
+      await new Promise((resolve26) => setTimeout(resolve26, Math.min(250 * attempt, 2e3)));
     }
   }
 }
@@ -16691,6 +16931,7 @@ function useCredentialsControls(handlers) {
 }
 
 // packages/experience-design-system-cli/src/tui/user-agent.ts
+init_version();
 function cliUserAgent() {
   return buildUserAgent(readPackageVersion());
 }
@@ -17190,34 +17431,8 @@ function ExtractionScreen({
   );
 }
 
-// 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/app.tsx
+init_config();
 
 // 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";
@@ -17493,6 +17708,7 @@ function useExtraction(input) {
         reuseTokens: input.tokenStrategy === "reuse"
       })
     });
+    void Promise.resolve().then(() => (init_debug_store(), debug_store_exports)).then((store) => store.startDebugSessionIn(input.projectPath));
     void runExtraction(input, (progress) => {
       if (current.current === input) setState({ status: "running", progress });
     }).then((result) => {
@@ -20379,7 +20595,7 @@ function GenerationScreen({
 import { useEffect as useEffect9, 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";
+import { resolve as resolve24 } from "node:path";
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/map-tokens.ts
 async function prepareMapTokens(input, generatedSessionId) {
@@ -20514,7 +20730,7 @@ async function buildMapTokensOptions(input) {
   if (mapOverride?.kind === "text") prompt.skillContentOverride = mapOverride.value;
   if (mapOverride?.kind === "path") {
     await resolvePromptOverride(mapOverride);
-    prompt.skillPathOverride = resolve23(mapOverride.value);
+    prompt.skillPathOverride = resolve24(mapOverride.value);
   }
   if (input.existingEntitiesPath) {
     const entities = await readExistingContentfulEntitiesFromSession({ path: input.existingEntitiesPath });
@@ -20562,7 +20778,7 @@ function useGeneration(input) {
 }
 
 // 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 join21 } from "node:path";
 function buildFlowStart(input) {
   const { extraction, handoff, saved, generatePromptPath } = input;
   const credentials = extraction.credentials ?? {
@@ -20575,7 +20791,7 @@ function buildFlowStart(input) {
     handoff,
     agent: extraction.agent,
     projectPath: extraction.projectPath,
-    outDir: extraction.projectPath ? join20(extraction.projectPath, ".contentful") : "",
+    outDir: extraction.projectPath ? join21(extraction.projectPath, ".contentful") : "",
     rawTokensPath: extraction.rawTokensPath,
     credentials: {
       spaceId: credentials.spaceId,
@@ -26318,11 +26534,11 @@ function DoneStep({
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/screens/PathPrompt.tsx
 import { useState as useState24 } from "react";
 import { Box as Box37, Text as Text40 } from "ink";
-import { readdirSync as readdirSync3 } from "node:fs";
-import { dirname as dirname15, basename as basename6, join as join21 } from "node:path";
+import { readdirSync as readdirSync4 } from "node:fs";
+import { dirname as dirname15, basename as basename6, join as join22 } from "node:path";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/path-utils.ts
-import { resolve as resolve24 } from "node:path";
+import { resolve as resolve25 } from "node:path";
 import { homedir as homedir4 } from "node:os";
 function expandTilde(input) {
   if (input === "~" || input.startsWith("~/") || input.startsWith("~\\")) {
@@ -26336,7 +26552,7 @@ function normalizePath(input) {
     p = p.slice(1, -1);
   }
   p = expandTilde(p);
-  return resolve24(p);
+  return resolve25(p);
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-blinking-cursor.ts
@@ -26359,19 +26575,19 @@ function autocomplete(partial) {
   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 join22(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 ? join22(dir, prefix) : null;
 }
 function PathPrompt({
   defaultPath,
@@ -27130,9 +27346,9 @@ import { useEffect as useEffect21, useRef as useRef13, useSyncExternalStore } fr
 
 // 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 } from "node:path";
+import { join as join24 } from "node:path";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/wizard-state-transitions.ts
 function shouldBypassPreview(state) {
@@ -27476,8 +27692,8 @@ function pushFailure(e, deps) {
 }
 
 // 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 join23 } from "node:path";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/run-print-files-helpers.ts
 function nextStateAfterPrint(opts) {
@@ -27500,15 +27716,15 @@ function buildSavedCDF(components, tokens, opts = {}) {
 var 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((resolve25) => setTimeout(resolve25, ms)),
+  sleep: (ms) => new Promise((resolve26) => setTimeout(resolve26, ms)),
   warn: (message) => process.stderr.write(message)
 });
 async function runPrintFiles(input, deps, onPatch) {
   onPatch({ step: "printing" });
-  const componentsPath = join22(input.outDir, "components.json");
+  const componentsPath = join23(input.outDir, "components.json");
   try {
     const db = deps.openDb();
     let components = [];
@@ -27589,7 +27805,7 @@ var EMPTY_PUSH_RESULT = {
 };
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/controller.ts
-var WIZARD_LOG = join23(tmpdir(), "experiences-import-wizard.log");
+var WIZARD_LOG = join24(tmpdir(), "experiences-import-wizard.log");
 function appendWizardLog(entry) {
   appendFileSync(WIZARD_LOG, JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry }) + "\n");
 }
@@ -27612,7 +27828,7 @@ function realFlowDeps() {
       }
     },
     mkdir: async (path5) => {
-      await mkdir8(path5, { recursive: true });
+      await mkdir9(path5, { recursive: true });
     },
     detectSaveConflict,
     buildTimestampedSubdir,
@@ -27876,171 +28092,19 @@ function useFlow(start, deps = realFlowDeps) {
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
 import { useEffect as useEffect22, useState as useState27 } from "react";
 import { Box as Box42, Text as Text44, useInput as useInput9 } from "ink";
-
-// 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);
-  });
-});
+init_debug_store();
 
 // 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: "Debug logs", value: debugSessionsDir2() }
+      { label: "Settings file", value: configFilePath2() }
     ],
     troubleshooting: [
       { label: "CLI version", value: readPackageVersion() },
@@ -28049,7 +28113,7 @@ async function readHelpInfo() {
       { label: "Debug Mode", value: debugMode.enabled ? "on" : "off" },
       {
         label: "This session",
-        value: debugMode.enabled ? currentDebugSessionDir() : "no logs written while Debug Mode is off"
+        value: !debugMode.enabled ? "no logs written while Debug Mode is off" : currentDebugSessionDir() ?? "not started: set the default project directory in Settings, or start an import"
       }
     ]
   };
@@ -28166,6 +28230,7 @@ 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;
 
@@ -28178,7 +28243,8 @@ async function readCredentials() {
     cmaToken: store.cmaToken || "",
     host: store.host || "",
     defaultComponentDir: store.defaultComponentDir || "",
-    defaultTokenFile: store.defaultTokenFile || ""
+    defaultTokenFile: store.defaultTokenFile || "",
+    contentfulBaseDir: store.contentfulBaseDir || ""
   };
 }
 async function writeCredentials(config) {
@@ -28194,6 +28260,7 @@ 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",
@@ -28201,7 +28268,8 @@ var FIELD_ORDER = [
   "cmaToken",
   "host",
   "defaultComponentDir",
-  "defaultTokenFile"
+  "defaultTokenFile",
+  "contentfulBaseDir"
 ];
 function debugFields(config) {
   return {
@@ -28210,7 +28278,8 @@ function debugFields(config) {
     cma_token: config?.cmaToken ?? "",
     host: config?.host ?? "",
     default_component_dir: config?.defaultComponentDir ?? "",
-    default_token_file: config?.defaultTokenFile ?? ""
+    default_token_file: config?.defaultTokenFile ?? "",
+    contentful_base_dir: config?.contentfulBaseDir ?? ""
   };
 }
 var FIELD_LABELS = {
@@ -28219,7 +28288,8 @@ var FIELD_LABELS = {
   cmaToken: "CMA Token",
   host: "API Host (optional)",
   defaultComponentDir: "Default component directory (optional)",
-  defaultTokenFile: "Default token file (optional)"
+  defaultTokenFile: "Default token file (optional)",
+  contentfulBaseDir: "Default project directory, where .contentful goes (optional)"
 };
 function ConfigurationScreen({ onDone }) {
   const [stage, setStage] = useState29("loading");
@@ -28256,6 +28326,7 @@ function ConfigurationScreen({ onDone }) {
     setNotice(null);
     writeCredentials(config).then(() => {
       setLastSaved(config);
+      if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir);
       setNotice({ kind: "success", text: "Configuration saved" });
       setStage("form");
     }).catch((err) => {
@@ -28385,6 +28456,7 @@ 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);
@@ -28445,6 +28517,8 @@ function OptInAnalyticsScreen({ onDone }) {
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
 import { useEffect as useEffect25, 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 }) {
@@ -28516,6 +28590,8 @@ 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 { 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);