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

package/dist/index.js

@@ -2121,7 +2121,7 @@ async function runAgent(options) {
     promptLen: prompt.length,
     promptHead: prompt.slice(0, 500)
   });
-  return new Promise((resolve26) => {
+  return new Promise((resolve27) => {
     const bedrockEnv = bedrock ? BEDROCK_ENV_BY_AGENT[agent] : void 0;
     const child = spawn3(binary, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -2170,7 +2170,7 @@ async function runAgent(options) {
         stderrLen: stderr.length,
         stderrTail: stderr.slice(-1e3)
       });
-      resolve26(result);
+      resolve27(result);
     });
   });
 }
@@ -2192,7 +2192,7 @@ async function checkAgentAuth(agent) {
     return "not-found";
   if (agent !== "claude")
     return "ok";
-  return new Promise((resolve26) => {
+  return new Promise((resolve27) => {
     const child = spawn4(binary, ["auth", "status", "--json"], { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let done = false;
@@ -2201,7 +2201,7 @@ async function checkAgentAuth(agent) {
         return;
       done = true;
       child.kill("SIGTERM");
-      resolve26("unauthenticated");
+      resolve27("unauthenticated");
     }, 5e3);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
@@ -2212,14 +2212,14 @@ async function checkAgentAuth(agent) {
       done = true;
       clearTimeout(timer);
       if (code !== 0) {
-        resolve26("unauthenticated");
+        resolve27("unauthenticated");
         return;
       }
       try {
         const status = JSON.parse(stdout);
-        resolve26(status.loggedIn ? "ok" : "unauthenticated");
+        resolve27(status.loggedIn ? "ok" : "unauthenticated");
       } catch {
-        resolve26("unauthenticated");
+        resolve27("unauthenticated");
       }
     });
   });
@@ -2229,9 +2229,9 @@ async function binaryIsOnPath(binary) {
     const fs = await import("node:fs/promises");
     return fs.access(binary).then(() => true, () => false);
   }
-  return new Promise((resolve26) => {
+  return new Promise((resolve27) => {
     const child = spawn4(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
-    child.on("close", (code) => resolve26(code === 0));
+    child.on("close", (code) => resolve27(code === 0));
   });
 }
 var init_check_agent_auth = __esm({
@@ -14901,7 +14901,7 @@ function errorMessage(error) {
   return error instanceof Error && error.message ? error.message : String(error);
 }
 function defaultSleep(delayMs) {
-  return new Promise((resolve26) => setTimeout(resolve26, delayMs));
+  return new Promise((resolve27) => setTimeout(resolve27, delayMs));
 }
 var MAX_RETRY_AFTER_MS;
 var init_http_utils = __esm({
@@ -15177,7 +15177,7 @@ var init_api_client = __esm({
             const progress = maxAttempts > 1 ? attempt / (maxAttempts - 1) : 0;
             const baseDelay = intervalMs + (maxIntervalMs - intervalMs) * progress;
             const jitter = Math.random() * baseDelay * 0.15;
-            await new Promise((resolve26) => setTimeout(resolve26, baseDelay + jitter));
+            await new Promise((resolve27) => setTimeout(resolve27, baseDelay + jitter));
           }
         }
         throw new Error(`Operation ${operationId} timed out after ${maxAttempts} attempts`);
@@ -18734,7 +18734,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((resolve26) => setTimeout(resolve26, Math.min(250 * attempt, 2e3)));
+      await new Promise((resolve27) => setTimeout(resolve27, Math.min(250 * attempt, 2e3)));
     }
   }
 }
@@ -20301,11 +20301,34 @@ var init_shared2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/05-token-reuse/logic.ts
-import { access as access5, stat as stat4 } from "node:fs/promises";
+import { access as access5, readdir as readdir2, stat as stat4 } from "node:fs/promises";
 import { join as join18 } from "node:path";
-async function inspectTokens({ rawTokensPath, outDir, cache }) {
+async function findLatestTokens(contentfulDir) {
+  const candidates = [join18(contentfulDir, "tokens.json")];
+  try {
+    for (const session of await readdir2(contentfulDir, { withFileTypes: true })) {
+      if (!session.isDirectory()) continue;
+      for (const run of await readdir2(join18(contentfulDir, session.name), { withFileTypes: true }).catch(() => [])) {
+        if (run.isDirectory() && /^dsi-import-\d+$/.test(run.name)) {
+          candidates.push(join18(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 }) {
   if (!cache) return { kind: "none" };
-  const tokensPath = join18(outDir, "tokens.json");
+  const tokensPath = await findLatestTokens(contentfulDir);
+  if (!tokensPath) return { kind: "none" };
   try {
     await access5(tokensPath);
   } catch {
@@ -20653,7 +20676,7 @@ var init_selection2 = __esm({
 import { mkdir as mkdir7 } from "node:fs/promises";
 import { join as join21, resolve as resolve22 } from "node:path";
 async function runExtraction(input, onProgress, deps = realDeps) {
-  const outDir = join21(resolve22(input.projectPath), ".contentful");
+  const outDir = input.outDir ?? join21(resolve22(input.projectPath), ".contentful");
   let progress = initialProgress({
     hasCredentials: input.credentials !== null,
     hasRawTokens: input.rawTokensPath !== "",
@@ -20804,203 +20827,6 @@ var init_run = __esm({
   }
 });
 
-// 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
-});
-import { mkdir as mkdir8, writeFile as writeFile7 } from "node:fs/promises";
-import { existsSync as existsSync11, readdirSync as readdirSync3 } from "node:fs";
-import { join as join22, 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 = existsSync11(contentfulDir) ? readdirSync3(contentfulDir) : [];
-  const seqPattern = new RegExp(`^${today}-session-(\\d+)$`);
-  const maxSeq = existing.reduce((max, entry) => {
-    const match2 = seqPattern.exec(entry);
-    return match2 ? Math.max(max, Number(match2[1])) : max;
-  }, 0);
-  return `${today}-session-${maxSeq + 1}`;
-}
-function startSession(base, { replace }) {
-  const contentfulDir = join22(base, ".contentful");
-  if (replace || !sessionDir) sessionDir = join22(contentfulDir, nextSessionId(contentfulDir));
-  return sessionDir;
-}
-function currentDebugSessionDir() {
-  return sessionDir && join22(sessionDir, "debug");
-}
-function currentSessionDir() {
-  return sessionDir;
-}
-async function startDebugSessionIn(base, { replace = false } = {}) {
-  try {
-    if (!await isDebugModeEnabled()) return;
-    await mkdir8(join22(startSession(resolve23(base), { replace }), "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 = join22(root, ...flowSegments);
-  await mkdir8(dir, { recursive: true });
-  const filename = nextAttemptFilename(dir, run.menuOption);
-  await writeFile7(join22(dir, filename), content, { mode: 384 });
-}
-function nextAttemptFilename(dir, menuOption) {
-  const today = datePrefix();
-  const optionSlug = slugify(menuOption);
-  const existing = existsSync11(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(join22(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/src/tui/import/steps/06-extraction/use-extraction.ts
 import { useEffect as useEffect5, useRef as useRef2, useState as useState8 } from "react";
 function useExtraction(input) {
@@ -21020,7 +20846,6 @@ 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) => {
@@ -24242,7 +24067,7 @@ var init_save_decisions = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/08-generation/run.ts
-import { resolve as resolve24 } from "node:path";
+import { resolve as resolve23 } from "node:path";
 async function runGeneration(input, onProgress, deps = realDeps3) {
   let progress = { components: null, mapTokens: "idle", mapTokensEligible: null };
   const update = (change) => {
@@ -24328,7 +24153,7 @@ async function buildMapTokensOptions(input) {
   if (mapOverride?.kind === "text") prompt.skillContentOverride = mapOverride.value;
   if (mapOverride?.kind === "path") {
     await resolvePromptOverride(mapOverride);
-    prompt.skillPathOverride = resolve24(mapOverride.value);
+    prompt.skillPathOverride = resolve23(mapOverride.value);
   }
   if (input.existingEntitiesPath) {
     const entities = await readExistingContentfulEntitiesFromSession({ path: input.existingEntitiesPath });
@@ -24406,7 +24231,7 @@ var init_use_generation = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/build-flow-start.ts
-import { join as join23 } from "node:path";
+import { join as join22 } from "node:path";
 function buildFlowStart(input) {
   const { extraction, handoff, saved, generatePromptPath } = input;
   const credentials = extraction.credentials ?? {
@@ -24419,7 +24244,7 @@ function buildFlowStart(input) {
     handoff,
     agent: extraction.agent,
     projectPath: extraction.projectPath,
-    outDir: extraction.projectPath ? join23(extraction.projectPath, ".contentful") : "",
+    outDir: extraction.projectPath ? join22(extraction.projectPath, ".contentful") : "",
     rawTokensPath: extraction.rawTokensPath,
     credentials: {
       spaceId: credentials.spaceId,
@@ -30615,7 +30440,7 @@ var init_DoneStep = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/path-utils.ts
-import { resolve as resolve25 } from "node:path";
+import { resolve as resolve24 } from "node:path";
 import { homedir as homedir4 } from "node:os";
 function expandTilde(input) {
   if (input === "~" || input.startsWith("~/") || input.startsWith("~\\")) {
@@ -30629,7 +30454,7 @@ function normalizePath(input) {
     p = p.slice(1, -1);
   }
   p = expandTilde(p);
-  return resolve25(p);
+  return resolve24(p);
 }
 var init_path_utils = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/path-utils.ts"() {
@@ -30656,8 +30481,8 @@ var init_use_blinking_cursor = __esm({
 // 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 readdirSync4 } from "node:fs";
-import { dirname as dirname15, basename as basename6, join as join24 } from "node:path";
+import { readdirSync as readdirSync3 } from "node:fs";
+import { dirname as dirname15, basename as basename6, join as join23 } from "node:path";
 import { jsx as jsx47, jsxs as jsxs38 } from "react/jsx-runtime";
 function autocomplete(partial) {
   if (!partial) return null;
@@ -30666,19 +30491,19 @@ function autocomplete(partial) {
   const base = basename6(normalized);
   let entries;
   try {
-    entries = readdirSync4(dir);
+    entries = readdirSync3(dir);
   } catch {
     return null;
   }
   const matches = entries.filter((e) => e.startsWith(base));
   if (matches.length === 0) return null;
-  if (matches.length === 1) return join24(dir, matches[0]);
+  if (matches.length === 1) return join23(dir, matches[0]);
   let prefix = matches[0];
   for (const m of matches) {
     while (!m.startsWith(prefix)) prefix = prefix.slice(0, -1);
     if (!prefix) break;
   }
-  return prefix.length > base.length ? join24(dir, prefix) : null;
+  return prefix.length > base.length ? join23(dir, prefix) : null;
 }
 function PathPrompt({
   defaultPath,
@@ -31881,8 +31706,8 @@ var init_run_print_files_helpers = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/save.ts
-import { writeFile as writeFile8 } from "node:fs/promises";
-import { join as join25 } from "node:path";
+import { writeFile as writeFile7 } from "node:fs/promises";
+import { join as join24 } from "node:path";
 function buildSavedCDF(components, tokens, opts = {}) {
   const cdf = buildCDF2(components, toCdfTokens(tokens), opts);
   if (!cdf) throw new Error("nothing to save \u2014 no components or tokens resolved");
@@ -31894,7 +31719,7 @@ function buildSavedCDF(components, tokens, opts = {}) {
 }
 async function runPrintFiles(input, deps, onPatch) {
   onPatch({ step: "printing" });
-  const componentsPath = join25(input.outDir, "components.json");
+  const componentsPath = join24(input.outDir, "components.json");
   try {
     const db = deps.openDb();
     let components = [];
@@ -31978,10 +31803,10 @@ var init_save = __esm({
     realSaveDeps = () => ({
       openDb: openPipelineDb,
       readTokens: (path5) => readTokensFromPath2({ flag: "tokens", path: path5 }),
-      writeFile: (path5, contents) => writeFile8(path5, contents),
+      writeFile: (path5, contents) => writeFile7(path5, contents),
       appendRun,
       buildSourceFingerprint,
-      sleep: (ms) => new Promise((resolve26) => setTimeout(resolve26, ms)),
+      sleep: (ms) => new Promise((resolve27) => setTimeout(resolve27, ms)),
       warn: (message) => process.stderr.write(message)
     });
   }
@@ -32001,9 +31826,9 @@ var init_types9 = __esm({
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/controller.ts
 import { appendFileSync, writeFileSync } from "node:fs";
-import { mkdir as mkdir9 } from "node:fs/promises";
+import { mkdir as mkdir8 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join26 } from "node:path";
+import { join as join25, resolve as resolve25 } from "node:path";
 function appendWizardLog(entry) {
   appendFileSync(WIZARD_LOG, JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry }) + "\n");
 }
@@ -32011,9 +31836,6 @@ function startWizardLog() {
   writeFileSync(WIZARD_LOG, `--- experiences import session ${(/* @__PURE__ */ new Date()).toISOString()} ---
 `);
 }
-async function realSessionDir() {
-  return (await Promise.resolve().then(() => (init_debug_store(), debug_store_exports))).currentSessionDir();
-}
 function realFlowDeps() {
   const log = (entry) => appendWizardLog(entry);
   return {
@@ -32029,14 +31851,13 @@ function realFlowDeps() {
       }
     },
     mkdir: async (path5) => {
-      await mkdir9(path5, { recursive: true });
+      await mkdir8(path5, { recursive: true });
     },
     detectSaveConflict,
     buildTimestampedSubdir,
     rejectComponentsByName,
     log,
-    stderr: (text) => process.stderr.write(text),
-    sessionDir: realSessionDir
+    stderr: (text) => process.stderr.write(text)
   };
 }
 function initialFlowState(start) {
@@ -32177,9 +31998,6 @@ function createFlowController(start, deps) {
   const startSave = (opts, patch = {}) => {
     pendingSave = opts;
     update({ ...patch, step: "path-prompt" });
-    void deps.sessionDir?.().then((session) => {
-      if (session && state.step === "path-prompt") update({ outDir: join26(session, "dsi-import") });
-    });
   };
   const proceedToWrite = async (path5) => {
     update({ outDir: path5 });
@@ -32252,7 +32070,7 @@ function createFlowController(start, deps) {
     },
     async submitPath(submitted) {
       await deps.mkdir(submitted);
-      if (await deps.detectSaveConflict(submitted)) {
+      if (resolve25(submitted) !== resolve25(state.outDir) && await deps.detectSaveConflict(submitted)) {
         const subdir = deps.buildTimestampedSubdir(submitted);
         await deps.mkdir(subdir);
         await proceedToWrite(subdir);
@@ -32284,7 +32102,7 @@ var init_controller = __esm({
     init_push();
     init_save();
     init_types9();
-    WIZARD_LOG = join26(tmpdir(), "experiences-import-wizard.log");
+    WIZARD_LOG = join25(tmpdir(), "experiences-import-wizard.log");
   }
 });
 
@@ -32316,6 +32134,219 @@ var init_use_flow = __esm({
   }
 });
 
+// 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 existsSync11, readdirSync as readdirSync4 } from "node:fs";
+import { join as join26, 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 = existsSync11(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 = join26(base, ".contentful");
+  if (replace || !sessionDir) sessionDir = join26(contentfulDir, nextSessionId(contentfulDir));
+  return sessionDir;
+}
+function currentDebugSessionDir() {
+  return sessionDir && join26(sessionDir, "debug");
+}
+function currentSessionDir() {
+  return sessionDir;
+}
+async function startDebugSessionIn(base, { replace = false } = {}) {
+  try {
+    if (!await isDebugModeEnabled()) return;
+    await mkdir9(join26(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
+  } catch {
+  }
+}
+function nextImportRunDir(session) {
+  const existing = existsSync11(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 join26(session, `dsi-import-${maxRun + 1}`);
+}
+async function startImportRun(projectPath) {
+  await startDebugSessionIn(projectPath);
+  if (!sessionDir) return join26(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 = join26(root, ...flowSegments);
+  await mkdir9(dir, { recursive: true });
+  const filename = nextAttemptFilename(dir, run.menuOption);
+  await writeFile8(join26(dir, filename), content, { mode: 384 });
+}
+function nextAttemptFilename(dir, menuOption) {
+  const today = datePrefix();
+  const optionSlug = slugify(menuOption);
+  const existing = existsSync11(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(join26(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/src/tui/help/help-info.ts
 async function readHelpInfo() {
   const debugMode = await readDebugModeSetting();
@@ -32627,10 +32658,7 @@ 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__ */ jsxs45(Text46, { bold: isActive, children: [
-          FIELD_LABELS[field],
-          ":"
-        ] }),
+        /* @__PURE__ */ jsx55(Box44, { width: LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: FIELD_LABELS[field] }) }),
         isActive && editing ? /* @__PURE__ */ jsx55(
           TextInput4,
           {
@@ -32639,7 +32667,8 @@ function ConfigurationScreen({ onDone }) {
             onSubmit: () => setEditing(false),
             mask: field === "cmaToken" ? "\u2022" : void 0
           }
-        ) : /* @__PURE__ */ jsx55(Text46, { children: display || /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" }) })
+        ) : /* @__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] })
       ] }, field);
     }) }),
     notice && /* @__PURE__ */ jsxs45(Fragment17, { children: [
@@ -32670,7 +32699,7 @@ function ConfigurationScreen({ onDone }) {
     )
   ] });
 }
-var FIELD_ORDER, FIELD_LABELS;
+var FIELD_ORDER, FIELD_LABELS, FIELD_HINTS, LABEL_WIDTH;
 var init_ContentfulConfigScreen = __esm({
   "packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx"() {
     "use strict";
@@ -32694,8 +32723,12 @@ var init_ContentfulConfigScreen = __esm({
       host: "API Host",
       defaultComponentDir: "Default component directory",
       defaultTokenFile: "Default token file",
-      contentfulBaseDir: "Root Project Directory (where .contentful goes)"
+      contentfulBaseDir: "Root Project Directory"
+    };
+    FIELD_HINTS = {
+      contentfulBaseDir: "(where .contentful goes)"
     };
+    LABEL_WIDTH = Math.max(...Object.values(FIELD_LABELS).map((label) => label.length));
   }
 });
 
@@ -32989,7 +33022,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state = await inspectTokens({
       rawTokensPath: tokens,
-      outDir: join27(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join27(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state.kind === "cached") {
@@ -33010,6 +33043,7 @@ 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
@@ -33018,6 +33052,7 @@ function App({ importOptions, inkClear }) {
       tokenStrategy,
       input: {
         projectPath: resolveUserPath(launch.projectPath ?? ""),
+        outDir,
         filePaths: launch.filePaths ?? [],
         rawTokensPath: launch.tokens ?? "",
         tokenStrategy,
@@ -33365,14 +33400,14 @@ function runDevWatch(args) {
     process.stderr.write("--watch only works from a checkout of the repo (scripts/dev.mjs is not in the package).\n");
     return Promise.resolve(1);
   }
-  return new Promise((resolve26) => {
+  return new Promise((resolve27) => {
     const child = spawn2(process.execPath, [script, ...args], { stdio: "inherit" });
     process.on("SIGINT", () => void 0);
-    child.on("exit", (code) => resolve26(code ?? 0));
+    child.on("exit", (code) => resolve27(code ?? 0));
     child.on("error", (err) => {
       process.stderr.write(`${err.message}
 `);
-      resolve26(1);
+      resolve27(1);
     });
   });
 }