@contentful/experience-design-system-cli 2.37.1-dev-build-4e7e3ced.0 → 2.37.1-dev-build-81dbe125.0

package/dist/app.js

@@ -2116,21 +2116,86 @@ var init_config = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts
+function toRetentionDays(value) {
+  return RETENTION_CHOICES.find((choice) => choice === value) ?? DEFAULT_RETENTION_DAYS;
+}
 async function readDebugModeSetting() {
   const { debugMode } = await readSettings2();
-  return { ...DEFAULT_DEBUG_MODE_SETTING, ...debugMode };
+  const saved = debugMode ?? {};
+  return {
+    enabled: typeof saved.enabled === "boolean" ? saved.enabled : true,
+    retentionDays: toRetentionDays(saved.retentionDays)
+  };
 }
-async function writeDebugModeSetting(setting) {
-  await updateSettings2({ debugMode: setting });
+async function writeDebugModeSetting(change) {
+  await updateSettings2({ debugMode: { ...await readDebugModeSetting(), ...change } });
 }
-var DEFAULT_DEBUG_MODE_SETTING;
+var RETENTION_CHOICES, DEFAULT_RETENTION_DAYS;
 var init_debug_mode_store = __esm({
   "packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts"() {
     "use strict";
     init_config();
-    DEFAULT_DEBUG_MODE_SETTING = {
-      enabled: true
-    };
+    RETENTION_CHOICES = [7, 14, 30];
+    DEFAULT_RETENTION_DAYS = 30;
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/debug-prune.ts
+import { readdir as readdir3, rm, rmdir, stat as stat5 } from "node:fs/promises";
+import { dirname as dirname16, join as join24 } from "node:path";
+async function logFilesIn(dir) {
+  const entries = await readdir3(dir, { withFileTypes: true });
+  const nested = await Promise.all(
+    entries.map(async (entry) => {
+      const path5 = join24(dir, entry.name);
+      if (entry.isDirectory()) return logFilesIn(path5);
+      return entry.isFile() && entry.name.endsWith(".md") ? [path5] : [];
+    })
+  );
+  return nested.flat();
+}
+async function removeEmptyFolders(from, stop) {
+  let dir = from;
+  let removed = 0;
+  for (; ; ) {
+    try {
+      await rmdir(dir);
+    } catch {
+      return removed;
+    }
+    removed += 1;
+    if (dir === stop) return removed;
+    dir = dirname16(dir);
+  }
+}
+async function pruneExpiredLogs(base, retentionDays, now = Date.now()) {
+  const cutoff = now - retentionDays * DAY_MS;
+  const contentfulDir = join24(base, ".contentful");
+  const result = { logs: 0, folders: 0 };
+  try {
+    const sessions = (await readdir3(contentfulDir)).filter((name) => SESSION_FOLDER.test(name));
+    for (const session of sessions) {
+      const files = await logFilesIn(join24(contentfulDir, session, "debug")).catch(() => []);
+      for (const file of files) {
+        try {
+          if ((await stat5(file)).mtimeMs >= cutoff) continue;
+          await rm(file);
+          result.logs += 1;
+          result.folders += await removeEmptyFolders(dirname16(file), join24(contentfulDir, session));
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return result;
+}
+var DAY_MS, SESSION_FOLDER;
+var init_debug_prune = __esm({
+  "packages/experience-design-system-cli/src/tui/debug-prune.ts"() {
+    "use strict";
+    DAY_MS = 24 * 60 * 60 * 1e3;
+    SESSION_FOLDER = /^\d{2}-\d{2}-\d{4}-session-\d+$/;
   }
 });
 
@@ -2146,7 +2211,7 @@ __export(debug_store_exports, {
 });
 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";
+import { join as join25, resolve as resolve26 } from "node:path";
 function generateRunId() {
   const now = /* @__PURE__ */ new Date();
   const pad = (n) => String(n).padStart(2, "0");
@@ -2178,12 +2243,12 @@ function nextSessionId(contentfulDir) {
   return `${today}-session-${maxSeq + 1}`;
 }
 function startSession(base, { replace }) {
-  const contentfulDir = join24(base, ".contentful");
-  if (replace || !sessionDir) sessionDir = join24(contentfulDir, nextSessionId(contentfulDir));
+  const contentfulDir = join25(base, ".contentful");
+  if (replace || !sessionDir) sessionDir = join25(contentfulDir, nextSessionId(contentfulDir));
   return sessionDir;
 }
 function currentDebugSessionDir() {
-  return sessionDir && join24(sessionDir, "debug");
+  return sessionDir && join25(sessionDir, "debug");
 }
 function currentSessionDir() {
   return sessionDir;
@@ -2191,7 +2256,7 @@ function currentSessionDir() {
 async function startDebugSessionIn(base, { replace = false } = {}) {
   try {
     if (!await isDebugModeEnabled()) return;
-    await mkdir9(join24(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
+    await mkdir9(join25(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
   } catch {
   }
 }
@@ -2201,11 +2266,11 @@ function nextImportRunDir(session) {
     const match2 = /^dsi-import-(\d+)$/.exec(entry);
     return match2 ? Math.max(max, Number(match2[1])) : max;
   }, 0);
-  return join24(session, `dsi-import-${maxRun + 1}`);
+  return join25(session, `dsi-import-${maxRun + 1}`);
 }
 async function startImportRun(projectPath) {
   await startDebugSessionIn(projectPath);
-  if (!sessionDir) return join24(resolve26(projectPath), ".contentful");
+  if (!sessionDir) return join25(resolve26(projectPath), ".contentful");
   const dir = nextImportRunDir(sessionDir);
   await mkdir9(dir, { recursive: true });
   return dir;
@@ -2252,10 +2317,10 @@ async function finishDebugRun({
   const root = currentDebugSessionDir();
   if (!root) return;
   const flowSegments = run.flow.split("/");
-  const dir = join24(root, ...flowSegments);
+  const dir = join25(root, ...flowSegments);
   await mkdir9(dir, { recursive: true });
   const filename = nextAttemptFilename(dir, run.menuOption);
-  await writeFile8(join24(dir, filename), content, { mode: 384 });
+  await writeFile8(join25(dir, filename), content, { mode: 384 });
 }
 function nextAttemptFilename(dir, menuOption) {
   const today = datePrefix();
@@ -2306,9 +2371,27 @@ var init_debug_store = __esm({
     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 });
+    init_debug_prune();
+    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(async ([enabled, base]) => {
+      if (!base) return;
+      const retention = await readDebugModeSetting().catch(() => void 0);
+      const pruned = retention ? await pruneExpiredLogs(base, retention.retentionDays).catch(() => void 0) : void 0;
+      if (!enabled) return;
+      const debugDir = join25(startSession(base, { replace: false }), "debug");
+      await mkdir9(debugDir, { recursive: true });
+      if (retention && pruned && pruned.logs + pruned.folders > 0) {
+        await writeFile8(
+          join25(debugDir, `${datePrefix()}-cleanup-${generateRunId()}.md`),
+          `# Debug Log Cleanup
+
+- Date: ${(/* @__PURE__ */ new Date()).toISOString()}
+- Retention: ${retention.retentionDays} days
+- Logs deleted: ${pruned.logs}
+- Empty folders removed: ${pruned.folders}
+`,
+          { mode: 384 }
+        );
+      }
     });
     process.once("uncaughtException", (err) => {
       void handleCrash().finally(() => {
@@ -2329,7 +2412,7 @@ var init_debug_store = __esm({
 });
 
 // packages/experience-design-system-cli/app.tsx
-import { join as join26 } from "node:path";
+import { join as join27 } from "node:path";
 import { useEffect as useEffect27, useState as useState36 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
@@ -8809,8 +8892,8 @@ function getWorkspacePackageDirs(workspaceRoot) {
         continue;
       const entryPath = join7(dir, entry);
       try {
-        const stat5 = statSync3(entryPath);
-        if (stat5.isDirectory()) {
+        const stat6 = statSync3(entryPath);
+        if (stat6.isDirectory()) {
           scanDir(entryPath, depth + 1);
         }
       } catch {
@@ -12897,15 +12980,15 @@ function walkProjectTree(dir, result, includeContent) {
 // packages/experience-design-system-backend-pipeline/dist/src/persistence/src/helpers/collect-files/collect-files.js
 function collectFiles(root, options = {}) {
   const resolved = path4.resolve(root);
-  let stat5;
+  let stat6;
   try {
-    stat5 = statSync4(resolved);
+    stat6 = statSync4(resolved);
   } catch (err) {
     return { ok: false, failure: classifyStatError(err.code), rootPath: resolved };
   }
-  if (stat5.isFile())
+  if (stat6.isFile())
     return { ok: false, failure: "is-file", rootPath: resolved };
-  if (!stat5.isDirectory())
+  if (!stat6.isDirectory())
     return { ok: false, failure: "not-directory", rootPath: resolved };
   const result = {
     filePaths: [],
@@ -27947,7 +28030,7 @@ init_debug_mode_store();
 init_version();
 
 // packages/experience-design-system-cli/src/tui/help/file-locations.ts
-import { join as join25, resolve as resolve27 } from "node:path";
+import { join as join26, resolve as resolve27 } from "node:path";
 function describeFileLocations({
   contentfulBaseDir,
   debugModeEnabled,
@@ -27956,14 +28039,14 @@ function describeFileLocations({
   if (!debugModeEnabled) {
     return {
       debugLogs: "none while Debug Mode is off",
-      importFiles: `${join25("<project>", ".contentful")}/ (tokens.json, components.json)`
+      importFiles: `${join26("<project>", ".contentful")}/ (tokens.json, components.json)`
     };
   }
   const base = contentfulBaseDir ? resolve27(contentfulBaseDir) : "<project>";
-  const session = currentSessionDir2 ?? join25(base, ".contentful", "<date>-session-<n>");
+  const session = currentSessionDir2 ?? join26(base, ".contentful", "<date>-session-<n>");
   return {
-    debugLogs: join25(session, "debug"),
-    importFiles: `${join25(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
+    debugLogs: join26(session, "debug"),
+    importFiles: `${join26(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
   };
 }
 
@@ -29212,55 +29295,137 @@ function OptInAnalyticsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect26, useState as useState35 } from "react";
+import { useEffect as useEffect26, useRef as useRef15, useState as useState35 } from "react";
 import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
-import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
+var ROWS = ["enabled", "retentionDays"];
+var snapshotOf2 = (setting) => ({
+  enabled: String(setting.enabled),
+  retentionDays: String(setting.retentionDays)
+});
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState35(true);
-  const [enabled, setEnabled] = useState35(true);
+  const [setting, setSetting] = useState35(null);
+  const [focus, setFocus] = useState35("enabled");
+  const [pending, setPending] = useState35(
+    RETENTION_CHOICES[RETENTION_CHOICES.length - 1]
+  );
+  const [notice, setNotice] = useState35(null);
+  const visit = useRef15({ trail: createTrail(), before: void 0, error: "" }).current;
   useEffect26(() => {
-    readDebugModeSetting().then((setting) => {
-      setEnabled(setting.enabled);
-      setLoading(false);
+    readDebugModeSetting().then((loaded) => {
+      setSetting(loaded);
+      setPending(loaded.retentionDays);
+      visit.before = snapshotOf2(loaded);
       startDebugRun({
         flow: "settings/debug-mode",
         step: "01-debug-mode",
         menuOption: "Debug Mode",
-        inputs: { enabled: setting.enabled }
+        inputs: { ...loaded }
       });
     });
   }, []);
+  const save = (patch, saved) => {
+    if (!setting) return;
+    const fields2 = Object.keys(patch).join(", ");
+    writeDebugModeSetting(patch).then(() => {
+      setSetting({ ...setting, ...patch });
+      visit.trail.record(`saved ${fields2}`);
+      setNotice({ kind: "success", text: `Saved: ${saved}` });
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      visit.trail.record(`saving ${fields2} failed`);
+      setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` });
+    });
+  };
+  const endVisit = (current) => {
+    const change = diffSnapshots(visit.before ?? snapshotOf2(current), snapshotOf2(current));
+    void finishDebugRun({
+      outputs: {
+        ...current,
+        ...change,
+        ...pending !== current.retentionDays ? { unsaved_retention_days: pending } : {},
+        actions: visit.trail.entries(),
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
   useInput16((input, key) => {
-    if (loading) return;
-    if (key.return || input === " ") {
-      setEnabled((current) => {
-        const next = !current;
-        void writeDebugModeSetting({ enabled: next });
-        return next;
-      });
+    if (!setting) return;
+    if (key.upArrow || key.downArrow) {
+      setFocus((current) => ROWS[(ROWS.indexOf(current) + (key.downArrow ? 1 : ROWS.length - 1)) % ROWS.length]);
+      setNotice(null);
+      return;
+    }
+    if ((key.leftArrow || key.rightArrow) && focus === "retentionDays") {
+      const index = RETENTION_CHOICES.indexOf(pending) + (key.rightArrow ? 1 : -1);
+      setPending(RETENTION_CHOICES[Math.min(Math.max(index, 0), RETENTION_CHOICES.length - 1)]);
+      setNotice(null);
+      return;
+    }
+    if (focus === "enabled" && (key.return || input === " ")) {
+      const enabled = !setting.enabled;
+      save({ enabled }, `debug logging is ${enabled ? "on" : "off"}`);
+      return;
+    }
+    if (focus === "retentionDays" && key.return) {
+      save({ retentionDays: pending }, `logs are deleted after ${pending} days`);
       return;
     }
     if (key.escape || input === "q") {
-      void finishDebugRun({ outputs: { enabled }, status: "success", exitMethod: "saved" });
+      endVisit(setting);
       onDone();
     }
   });
+  const marker = (row) => /* @__PURE__ */ jsx62(Text53, { color: focus === row ? PALETTE.accent : void 0, children: focus === row ? "\u276F" : " " });
+  const label = (row, text) => /* @__PURE__ */ jsx62(Text53, { bold: focus === row, color: focus === row ? PALETTE.accent : PALETTE.muted, children: text });
   return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
     /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Settings \u203A Debug Mode" }),
     /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    loading ? /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs51(Text53, { children: [
-      "Debug logging:",
-      " ",
-      /* @__PURE__ */ jsx62(Text53, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
-    ] }),
+    setting ? /* @__PURE__ */ jsxs51(Fragment21, { children: [
+      /* @__PURE__ */ jsxs51(Box50, { gap: 1, children: [
+        marker("enabled"),
+        label("enabled", "Debug logging:"),
+        /* @__PURE__ */ jsx62(Text53, { bold: true, color: setting.enabled ? PALETTE.success : PALETTE.muted, children: setting.enabled ? "On" : "Off" })
+      ] }),
+      /* @__PURE__ */ jsxs51(Box50, { gap: 1, children: [
+        marker("retentionDays"),
+        label("retentionDays", "Delete logs after:"),
+        RETENTION_CHOICES.map((days) => {
+          const highlighted = focus === "retentionDays" && days === pending;
+          const saved = days === setting.retentionDays;
+          return /* @__PURE__ */ jsx62(
+            Text53,
+            {
+              bold: highlighted || saved,
+              underline: highlighted,
+              color: highlighted ? PALETTE.accent : saved ? PALETTE.success : PALETTE.muted,
+              children: `${saved ? "\u2713 " : ""}${days} days`
+            },
+            days
+          );
+        })
+      ] }),
+      /* @__PURE__ */ jsx62(Text53, { children: " " }),
+      notice ? /* @__PURE__ */ jsxs51(Text53, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] }) : /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "\u2713 marks what is saved. Older logs are deleted the next time the CLI starts." })
+    ] }) : /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }),
     /* @__PURE__ */ jsx62(Text53, { children: " " }),
     /* @__PURE__ */ jsx62(
       ControlHints,
       {
         hints: [
-          { keys: "\u23CE/Space", label: "toggle" },
+          { keys: "\u2191/\u2193", label: "move" },
+          ...focus === "retentionDays" ? [
+            { keys: "\u2190/\u2192", label: "choose" },
+            { keys: "\u23CE", label: "save" }
+          ] : [{ keys: "\u23CE/Space", label: "toggle" }],
           { keys: "Esc/q", label: "back" }
         ]
       }
@@ -29269,7 +29434,7 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
+import { Fragment as Fragment22, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState36("start");
   const [importExitCode, setImportExitCode] = useState36();
@@ -29318,7 +29483,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state2 = await inspectTokens({
       rawTokensPath: tokens,
-      contentfulDir: join26(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join27(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state2.kind === "cached") {
@@ -29438,7 +29603,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment22, {});
       if (projectPath === void 0) {
         return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
@@ -29477,7 +29642,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment21, {});
+        return /* @__PURE__ */ jsx63(Fragment22, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
@@ -29514,7 +29679,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment21, {});
+        return /* @__PURE__ */ jsx63(Fragment22, {});
       }
       if (pendingLaunch?.cached) {
         return /* @__PURE__ */ jsx63(

package/dist/index.js

@@ -8266,8 +8266,8 @@ function getWorkspacePackageDirs(workspaceRoot) {
         continue;
       const entryPath = join5(dir, entry);
       try {
-        const stat5 = statSync2(entryPath);
-        if (stat5.isDirectory()) {
+        const stat6 = statSync2(entryPath);
+        if (stat6.isDirectory()) {
           scanDir(entryPath, depth + 1);
         }
       } catch {
@@ -12911,15 +12911,15 @@ import { statSync as statSync3 } from "node:fs";
 import path4 from "node:path";
 function collectFiles(root, options = {}) {
   const resolved = path4.resolve(root);
-  let stat5;
+  let stat6;
   try {
-    stat5 = statSync3(resolved);
+    stat6 = statSync3(resolved);
   } catch (err) {
     return { ok: false, failure: classifyStatError(err.code), rootPath: resolved };
   }
-  if (stat5.isFile())
+  if (stat6.isFile())
     return { ok: false, failure: "is-file", rootPath: resolved };
-  if (!stat5.isDirectory())
+  if (!stat6.isDirectory())
     return { ok: false, failure: "not-directory", rootPath: resolved };
   const result = {
     filePaths: [],
@@ -31283,21 +31283,86 @@ var init_use_flow = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts
+function toRetentionDays(value) {
+  return RETENTION_CHOICES.find((choice) => choice === value) ?? DEFAULT_RETENTION_DAYS;
+}
 async function readDebugModeSetting() {
   const { debugMode } = await readSettings2();
-  return { ...DEFAULT_DEBUG_MODE_SETTING, ...debugMode };
+  const saved = debugMode ?? {};
+  return {
+    enabled: typeof saved.enabled === "boolean" ? saved.enabled : true,
+    retentionDays: toRetentionDays(saved.retentionDays)
+  };
 }
-async function writeDebugModeSetting(setting) {
-  await updateSettings2({ debugMode: setting });
+async function writeDebugModeSetting(change) {
+  await updateSettings2({ debugMode: { ...await readDebugModeSetting(), ...change } });
 }
-var DEFAULT_DEBUG_MODE_SETTING;
+var RETENTION_CHOICES, DEFAULT_RETENTION_DAYS;
 var init_debug_mode_store = __esm({
   "packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts"() {
     "use strict";
     init_config();
-    DEFAULT_DEBUG_MODE_SETTING = {
-      enabled: true
-    };
+    RETENTION_CHOICES = [7, 14, 30];
+    DEFAULT_RETENTION_DAYS = 30;
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/debug-prune.ts
+import { readdir as readdir3, rm, rmdir, stat as stat5 } from "node:fs/promises";
+import { dirname as dirname16, join as join25 } from "node:path";
+async function logFilesIn(dir) {
+  const entries = await readdir3(dir, { withFileTypes: true });
+  const nested = await Promise.all(
+    entries.map(async (entry) => {
+      const path5 = join25(dir, entry.name);
+      if (entry.isDirectory()) return logFilesIn(path5);
+      return entry.isFile() && entry.name.endsWith(".md") ? [path5] : [];
+    })
+  );
+  return nested.flat();
+}
+async function removeEmptyFolders(from, stop) {
+  let dir = from;
+  let removed = 0;
+  for (; ; ) {
+    try {
+      await rmdir(dir);
+    } catch {
+      return removed;
+    }
+    removed += 1;
+    if (dir === stop) return removed;
+    dir = dirname16(dir);
+  }
+}
+async function pruneExpiredLogs(base, retentionDays, now = Date.now()) {
+  const cutoff = now - retentionDays * DAY_MS;
+  const contentfulDir = join25(base, ".contentful");
+  const result = { logs: 0, folders: 0 };
+  try {
+    const sessions = (await readdir3(contentfulDir)).filter((name) => SESSION_FOLDER.test(name));
+    for (const session of sessions) {
+      const files = await logFilesIn(join25(contentfulDir, session, "debug")).catch(() => []);
+      for (const file of files) {
+        try {
+          if ((await stat5(file)).mtimeMs >= cutoff) continue;
+          await rm(file);
+          result.logs += 1;
+          result.folders += await removeEmptyFolders(dirname16(file), join25(contentfulDir, session));
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return result;
+}
+var DAY_MS, SESSION_FOLDER;
+var init_debug_prune = __esm({
+  "packages/experience-design-system-cli/src/tui/debug-prune.ts"() {
+    "use strict";
+    DAY_MS = 24 * 60 * 60 * 1e3;
+    SESSION_FOLDER = /^\d{2}-\d{2}-\d{4}-session-\d+$/;
   }
 });
 
@@ -31313,7 +31378,7 @@ __export(debug_store_exports, {
 });
 import { mkdir as mkdir9, writeFile as writeFile8 } from "node:fs/promises";
 import { existsSync as existsSync10, readdirSync as readdirSync4 } from "node:fs";
-import { join as join25, resolve as resolve26 } from "node:path";
+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");
@@ -31345,12 +31410,12 @@ function nextSessionId(contentfulDir) {
   return `${today}-session-${maxSeq + 1}`;
 }
 function startSession(base, { replace }) {
-  const contentfulDir = join25(base, ".contentful");
-  if (replace || !sessionDir) sessionDir = join25(contentfulDir, nextSessionId(contentfulDir));
+  const contentfulDir = join26(base, ".contentful");
+  if (replace || !sessionDir) sessionDir = join26(contentfulDir, nextSessionId(contentfulDir));
   return sessionDir;
 }
 function currentDebugSessionDir() {
-  return sessionDir && join25(sessionDir, "debug");
+  return sessionDir && join26(sessionDir, "debug");
 }
 function currentSessionDir() {
   return sessionDir;
@@ -31358,7 +31423,7 @@ function currentSessionDir() {
 async function startDebugSessionIn(base, { replace = false } = {}) {
   try {
     if (!await isDebugModeEnabled()) return;
-    await mkdir9(join25(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
+    await mkdir9(join26(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
   } catch {
   }
 }
@@ -31368,11 +31433,11 @@ function nextImportRunDir(session) {
     const match2 = /^dsi-import-(\d+)$/.exec(entry);
     return match2 ? Math.max(max, Number(match2[1])) : max;
   }, 0);
-  return join25(session, `dsi-import-${maxRun + 1}`);
+  return join26(session, `dsi-import-${maxRun + 1}`);
 }
 async function startImportRun(projectPath) {
   await startDebugSessionIn(projectPath);
-  if (!sessionDir) return join25(resolve26(projectPath), ".contentful");
+  if (!sessionDir) return join26(resolve26(projectPath), ".contentful");
   const dir = nextImportRunDir(sessionDir);
   await mkdir9(dir, { recursive: true });
   return dir;
@@ -31419,10 +31484,10 @@ async function finishDebugRun({
   const root = currentDebugSessionDir();
   if (!root) return;
   const flowSegments = run.flow.split("/");
-  const dir = join25(root, ...flowSegments);
+  const dir = join26(root, ...flowSegments);
   await mkdir9(dir, { recursive: true });
   const filename = nextAttemptFilename(dir, run.menuOption);
-  await writeFile8(join25(dir, filename), content, { mode: 384 });
+  await writeFile8(join26(dir, filename), content, { mode: 384 });
 }
 function nextAttemptFilename(dir, menuOption) {
   const today = datePrefix();
@@ -31473,9 +31538,27 @@ var init_debug_store = __esm({
     init_config();
     init_version();
     init_debug_mode_store();
-    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(([enabled, base]) => {
-      if (!enabled || !base) return void 0;
-      return mkdir9(join25(startSession(base, { replace: false }), "debug"), { recursive: true });
+    init_debug_prune();
+    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(async ([enabled, base]) => {
+      if (!base) return;
+      const retention = await readDebugModeSetting().catch(() => void 0);
+      const pruned = retention ? await pruneExpiredLogs(base, retention.retentionDays).catch(() => void 0) : void 0;
+      if (!enabled) return;
+      const debugDir = join26(startSession(base, { replace: false }), "debug");
+      await mkdir9(debugDir, { recursive: true });
+      if (retention && pruned && pruned.logs + pruned.folders > 0) {
+        await writeFile8(
+          join26(debugDir, `${datePrefix()}-cleanup-${generateRunId()}.md`),
+          `# Debug Log Cleanup
+
+- Date: ${(/* @__PURE__ */ new Date()).toISOString()}
+- Retention: ${retention.retentionDays} days
+- Logs deleted: ${pruned.logs}
+- Empty folders removed: ${pruned.folders}
+`,
+          { mode: 384 }
+        );
+      }
     });
     process.once("uncaughtException", (err) => {
       void handleCrash().finally(() => {
@@ -31496,7 +31579,7 @@ var init_debug_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/help/file-locations.ts
-import { join as join26, resolve as resolve27 } from "node:path";
+import { join as join27, resolve as resolve27 } from "node:path";
 function describeFileLocations({
   contentfulBaseDir,
   debugModeEnabled,
@@ -31505,14 +31588,14 @@ function describeFileLocations({
   if (!debugModeEnabled) {
     return {
       debugLogs: "none while Debug Mode is off",
-      importFiles: `${join26("<project>", ".contentful")}/ (tokens.json, components.json)`
+      importFiles: `${join27("<project>", ".contentful")}/ (tokens.json, components.json)`
     };
   }
   const base = contentfulBaseDir ? resolve27(contentfulBaseDir) : "<project>";
-  const session = currentSessionDir2 ?? join26(base, ".contentful", "<date>-session-<n>");
+  const session = currentSessionDir2 ?? join27(base, ".contentful", "<date>-session-<n>");
   return {
-    debugLogs: join26(session, "debug"),
-    importFiles: `${join26(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
+    debugLogs: join27(session, "debug"),
+    importFiles: `${join27(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
   };
 }
 var init_file_locations = __esm({
@@ -32792,59 +32875,137 @@ var init_screen11 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect26, useState as useState35 } from "react";
+import { useEffect as useEffect26, useRef as useRef15, useState as useState35 } from "react";
 import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
-import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState35(true);
-  const [enabled, setEnabled] = useState35(true);
+  const [setting, setSetting] = useState35(null);
+  const [focus, setFocus] = useState35("enabled");
+  const [pending, setPending] = useState35(
+    RETENTION_CHOICES[RETENTION_CHOICES.length - 1]
+  );
+  const [notice, setNotice] = useState35(null);
+  const visit = useRef15({ trail: createTrail(), before: void 0, error: "" }).current;
   useEffect26(() => {
-    readDebugModeSetting().then((setting) => {
-      setEnabled(setting.enabled);
-      setLoading(false);
+    readDebugModeSetting().then((loaded) => {
+      setSetting(loaded);
+      setPending(loaded.retentionDays);
+      visit.before = snapshotOf2(loaded);
       startDebugRun({
         flow: "settings/debug-mode",
         step: "01-debug-mode",
         menuOption: "Debug Mode",
-        inputs: { enabled: setting.enabled }
+        inputs: { ...loaded }
       });
     });
   }, []);
+  const save = (patch, saved) => {
+    if (!setting) return;
+    const fields2 = Object.keys(patch).join(", ");
+    writeDebugModeSetting(patch).then(() => {
+      setSetting({ ...setting, ...patch });
+      visit.trail.record(`saved ${fields2}`);
+      setNotice({ kind: "success", text: `Saved: ${saved}` });
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      visit.trail.record(`saving ${fields2} failed`);
+      setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` });
+    });
+  };
+  const endVisit = (current) => {
+    const change = diffSnapshots(visit.before ?? snapshotOf2(current), snapshotOf2(current));
+    void finishDebugRun({
+      outputs: {
+        ...current,
+        ...change,
+        ...pending !== current.retentionDays ? { unsaved_retention_days: pending } : {},
+        actions: visit.trail.entries(),
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
   useInput16((input, key) => {
-    if (loading) return;
-    if (key.return || input === " ") {
-      setEnabled((current) => {
-        const next = !current;
-        void writeDebugModeSetting({ enabled: next });
-        return next;
-      });
+    if (!setting) return;
+    if (key.upArrow || key.downArrow) {
+      setFocus((current) => ROWS[(ROWS.indexOf(current) + (key.downArrow ? 1 : ROWS.length - 1)) % ROWS.length]);
+      setNotice(null);
+      return;
+    }
+    if ((key.leftArrow || key.rightArrow) && focus === "retentionDays") {
+      const index = RETENTION_CHOICES.indexOf(pending) + (key.rightArrow ? 1 : -1);
+      setPending(RETENTION_CHOICES[Math.min(Math.max(index, 0), RETENTION_CHOICES.length - 1)]);
+      setNotice(null);
+      return;
+    }
+    if (focus === "enabled" && (key.return || input === " ")) {
+      const enabled = !setting.enabled;
+      save({ enabled }, `debug logging is ${enabled ? "on" : "off"}`);
+      return;
+    }
+    if (focus === "retentionDays" && key.return) {
+      save({ retentionDays: pending }, `logs are deleted after ${pending} days`);
       return;
     }
     if (key.escape || input === "q") {
-      void finishDebugRun({ outputs: { enabled }, status: "success", exitMethod: "saved" });
+      endVisit(setting);
       onDone();
     }
   });
+  const marker = (row) => /* @__PURE__ */ jsx62(Text53, { color: focus === row ? PALETTE.accent : void 0, children: focus === row ? "\u276F" : " " });
+  const label = (row, text) => /* @__PURE__ */ jsx62(Text53, { bold: focus === row, color: focus === row ? PALETTE.accent : PALETTE.muted, children: text });
   return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
     /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Settings \u203A Debug Mode" }),
     /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    loading ? /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs51(Text53, { children: [
-      "Debug logging:",
-      " ",
-      /* @__PURE__ */ jsx62(Text53, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
-    ] }),
+    setting ? /* @__PURE__ */ jsxs51(Fragment21, { children: [
+      /* @__PURE__ */ jsxs51(Box50, { gap: 1, children: [
+        marker("enabled"),
+        label("enabled", "Debug logging:"),
+        /* @__PURE__ */ jsx62(Text53, { bold: true, color: setting.enabled ? PALETTE.success : PALETTE.muted, children: setting.enabled ? "On" : "Off" })
+      ] }),
+      /* @__PURE__ */ jsxs51(Box50, { gap: 1, children: [
+        marker("retentionDays"),
+        label("retentionDays", "Delete logs after:"),
+        RETENTION_CHOICES.map((days) => {
+          const highlighted = focus === "retentionDays" && days === pending;
+          const saved = days === setting.retentionDays;
+          return /* @__PURE__ */ jsx62(
+            Text53,
+            {
+              bold: highlighted || saved,
+              underline: highlighted,
+              color: highlighted ? PALETTE.accent : saved ? PALETTE.success : PALETTE.muted,
+              children: `${saved ? "\u2713 " : ""}${days} days`
+            },
+            days
+          );
+        })
+      ] }),
+      /* @__PURE__ */ jsx62(Text53, { children: " " }),
+      notice ? /* @__PURE__ */ jsxs51(Text53, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] }) : /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "\u2713 marks what is saved. Older logs are deleted the next time the CLI starts." })
+    ] }) : /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }),
     /* @__PURE__ */ jsx62(Text53, { children: " " }),
     /* @__PURE__ */ jsx62(
       ControlHints,
       {
         hints: [
-          { keys: "\u23CE/Space", label: "toggle" },
+          { keys: "\u2191/\u2193", label: "move" },
+          ...focus === "retentionDays" ? [
+            { keys: "\u2190/\u2192", label: "choose" },
+            { keys: "\u23CE", label: "save" }
+          ] : [{ keys: "\u23CE/Space", label: "toggle" }],
           { keys: "Esc/q", label: "back" }
         ]
       }
     )
   ] });
 }
+var ROWS, snapshotOf2;
 var init_screen12 = __esm({
   "packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx"() {
     "use strict";
@@ -32852,6 +33013,12 @@ var init_screen12 = __esm({
     init_debug_mode_store();
     init_debug_store();
     init_control_hints();
+    init_debug_trail();
+    ROWS = ["enabled", "retentionDays"];
+    snapshotOf2 = (setting) => ({
+      enabled: String(setting.enabled),
+      retentionDays: String(setting.retentionDays)
+    });
   }
 });
 
@@ -32860,9 +33027,9 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 import { useEffect as useEffect27, useState as useState36 } from "react";
-import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
+import { Fragment as Fragment22, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState36("start");
   const [importExitCode, setImportExitCode] = useState36();
@@ -32911,7 +33078,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state2 = await inspectTokens({
       rawTokensPath: tokens,
-      contentfulDir: join27(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join28(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state2.kind === "cached") {
@@ -33031,7 +33198,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment22, {});
       if (projectPath === void 0) {
         return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
@@ -33070,7 +33237,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment21, {});
+        return /* @__PURE__ */ jsx63(Fragment22, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
@@ -33107,7 +33274,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment21, {});
+        return /* @__PURE__ */ jsx63(Fragment22, {});
       }
       if (pendingLaunch?.cached) {
         return /* @__PURE__ */ jsx63(
@@ -33182,7 +33349,7 @@ var init_app = __esm({
 // packages/experience-design-system-cli/program.ts
 init_src3();
 import { readFileSync as readFileSync9 } from "node:fs";
-import { join as join28 } from "node:path";
+import { join as join29 } from "node:path";
 import { Command } from "commander";
 
 // packages/experience-design-system-cli/src/commands/import-options.ts
@@ -33248,7 +33415,7 @@ init_analytics_store();
 init_package_root();
 var pkg = JSON.parse(
   readFileSync9(
-    join28(findPackageRoot(import.meta.url, "@contentful/experience-design-system-cli"), "package.json"),
+    join29(findPackageRoot(import.meta.url, "@contentful/experience-design-system-cli"), "package.json"),
     "utf8"
   )
 );
@@ -33288,8 +33455,8 @@ function createProgram() {
 init_config();
 init_package_root();
 import { existsSync as existsSync12 } from "node:fs";
-import { mkdir as mkdir10, readFile as readFile19, rename as rename3, rmdir, unlink } from "node:fs/promises";
-import { dirname as dirname16, join as join29 } from "node:path";
+import { mkdir as mkdir10, readFile as readFile19, rename as rename3, rmdir as rmdir2, unlink } from "node:fs/promises";
+import { dirname as dirname17, join as join30 } from "node:path";
 var PACKAGE_NAME3 = "@contentful/experience-design-system-cli";
 async function readJson(path5) {
   try {
@@ -33300,9 +33467,9 @@ async function readJson(path5) {
 }
 async function migrateOldConfig() {
   try {
-    const oldCredentials = join29(oldConfigDir2(), "credentials.json");
-    const oldRuns = join29(oldConfigDir2(), "runs.json");
-    const oldDebugMode = join29(
+    const oldCredentials = join30(oldConfigDir2(), "credentials.json");
+    const oldRuns = join30(oldConfigDir2(), "runs.json");
+    const oldDebugMode = join30(
       findPackageRoot(import.meta.url, PACKAGE_NAME3),
       ".contentful",
       "config",
@@ -33315,14 +33482,14 @@ async function migrateOldConfig() {
     if (Object.keys(migrated).length > 0) await updateSettings2({ ...migrated, ...await readSettings2() });
     if (existsSync12(oldRuns)) {
       if (!existsSync12(runsFilePath2())) {
-        await mkdir10(dirname16(runsFilePath2()), { recursive: true });
+        await mkdir10(dirname17(runsFilePath2()), { recursive: true });
         await rename3(oldRuns, runsFilePath2());
       } else {
         await unlink(oldRuns);
       }
     }
     await Promise.all([oldCredentials, oldDebugMode].map((f) => unlink(f).catch(() => void 0)));
-    await rmdir(oldConfigDir2()).catch(() => void 0);
+    await rmdir2(oldConfigDir2()).catch(() => void 0);
   } catch {
   }
 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-4e7e3ced.0",
+  "version": "2.37.1-dev-build-81dbe125.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/debug-prune.d.ts

@@ -0,0 +1,12 @@
+export type PruneResult = {
+    logs: number;
+    folders: number;
+};
+/**
+ * Deletes the debug logs under `<base>/.contentful` that are older than `retentionDays`. It only looks at `.md` files
+ * inside the `debug` folder of a session folder, so nothing the import produced or the user put there is touched. A file
+ * that cannot be read or deleted is skipped: this runs at startup and must never get in the user's way. A folder the
+ * deletion left empty is removed too, up to the session folder; one that still holds anything stays. Returns how many
+ * logs and folders it deleted.
+ */
+export declare function pruneExpiredLogs(base: string, retentionDays: number, now?: number): Promise<PruneResult>;

package/dist/src/tui/settings/debug-mode/debug-mode-store.d.ts

@@ -1,5 +1,11 @@
+/** How long a debug log is kept before the CLI deletes it. Only these values are offered. */
+export declare const RETENTION_CHOICES: readonly [7, 14, 30];
+type RetentionDays = (typeof RETENTION_CHOICES)[number];
 export type DebugModeSetting = {
     enabled: boolean;
+    retentionDays: RetentionDays;
 };
 export declare function readDebugModeSetting(): Promise<DebugModeSetting>;
-export declare function writeDebugModeSetting(setting: DebugModeSetting): Promise<void>;
+/** Saves the given fields and keeps the others, so turning logging off does not forget the retention. */
+export declare function writeDebugModeSetting(change: Partial<DebugModeSetting>): Promise<void>;
+export {};

package/dist/src/tui/settings/debug-mode/screen.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
+/**
+ * Settings > Debug Mode. Logging is switched with Enter. The retention is chosen with ←/→, which only moves a highlight:
+ * nothing is saved until Enter, and then the screen says so.
+ */
 export declare function DebugModeScreen({ onDone }: {
     onDone: () => void;
 }): React.ReactElement;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-4e7e3ced.0",
+  "version": "2.37.1-dev-build-81dbe125.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-4e7e3ced.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-4e7e3ced.0"
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-81dbe125.0",
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-81dbe125.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",