@contentful/experience-design-system-cli 2.43.1-dev-build-b2134432.0 → 2.43.1-dev-build-1205d418.0

package/dist/app.js

@@ -2736,6 +2736,9 @@ var IMPORT_TARGET_OPTIONS = [
   { target: "tokens", label: "Design tokens only" },
   { target: "components", label: "Components only" }
 ];
+function importModeLabel(target) {
+  return IMPORT_TARGET_OPTIONS.find((option) => option.target === target).label;
+}
 var COMPONENTS_OVERVIEW = [
   { description: "Extract components from your codebase", ai: true },
   { description: "Review what was extracted", ai: false },
@@ -17642,9 +17645,8 @@ async function collectPreflightContext() {
 }
 function preflightLog(chosen, terminal, context) {
   const { columns, rows } = terminal;
-  const label = IMPORT_TARGET_OPTIONS.find((option) => option.target === chosen)?.label;
   const summary = [
-    label ? `Chose: ${label}` : "Left the import without choosing",
+    chosen ? `Chose: ${importModeLabel(chosen)}` : "Left the import without choosing",
     columns && rows ? `Terminal: ${columns} \xD7 ${rows}` : "Terminal: size unknown"
   ];
   if (context) {
@@ -18237,29 +18239,46 @@ function useWelcomeControls(onQuit) {
   });
 }
 
+// packages/experience-design-system-cli/src/tui/import/steps/01-welcome/log.ts
+function welcomeLog({
+  mode,
+  projectPath,
+  initialPath,
+  emptySubmits
+}) {
+  const kept = projectPath !== null && initialPath.trim() !== "" && projectPath === initialPath.trim();
+  const source = projectPath === null ? null : kept ? "prefilled" : "typed";
+  const summary = [
+    `Import mode: ${importModeLabel(mode)}`,
+    projectPath === null ? "Project path: none (left the import)" : `Project path: ${projectPath}`,
+    ...source ? [`Path source: ${source === "prefilled" ? "pre-filled, kept as is" : "typed by the user"}`] : [],
+    `Empty submits: ${emptySubmits}`
+  ];
+  return {
+    summary,
+    data: { import_mode: mode, project_path: projectPath, path_source: source, empty_submits: emptySubmits }
+  };
+}
+
 // packages/experience-design-system-cli/src/tui/import/steps/01-welcome/screen.tsx
 import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
 function WelcomeScreen({ mode, onContinue, onQuit, initialPath = "" }) {
   const [projectPath, setProjectPath] = useState6(initialPath);
   const visit = useRef3({ emptySubmits: 0 }).current;
   useEffect6(() => {
-    startDebugRun({
-      flow: "import/welcome",
-      step: "01-welcome",
-      menuOption: "Welcome",
-      inputs: { import_mode: mode, initial_path: initialPath }
-    });
+    startDebugRun({ flow: "import/welcome", step: "01-welcome", menuOption: "Welcome" });
   }, []);
-  const quit = () => {
-    void finishDebugRun({
-      outputs: {
-        project_path: null,
-        typed_something: toProjectPath(projectPath) !== null,
-        empty_submits: visit.emptySubmits
-      },
-      status: "success",
-      exitMethod: "discarded"
+  const finish = (path5) => {
+    const { summary, data } = welcomeLog({
+      mode,
+      projectPath: path5,
+      initialPath,
+      emptySubmits: visit.emptySubmits
     });
+    void finishDebugRun({ summary, outputs: data, status: "success", exitMethod: path5 ? "saved" : "discarded" });
+  };
+  const quit = () => {
+    finish(null);
     onQuit();
   };
   useWelcomeControls(quit);
@@ -18269,15 +18288,7 @@ function WelcomeScreen({ mode, onContinue, onQuit, initialPath = "" }) {
       visit.emptySubmits += 1;
       return;
     }
-    void finishDebugRun({
-      outputs: {
-        project_path: path5,
-        changed_from_initial: path5 !== initialPath.trim(),
-        empty_submits: visit.emptySubmits
-      },
-      status: "success",
-      exitMethod: "saved"
-    });
+    finish(path5);
     onContinue(path5);
   };
   return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", children: [
@@ -18325,6 +18336,40 @@ function useTokenInputControls(onBack) {
   });
 }
 
+// packages/experience-design-system-cli/src/tui/import/steps/02-token-input/log.ts
+function tokenInputLog({
+  mode,
+  tokenPath,
+  enteredPath,
+  initialPath,
+  rejected,
+  emptySubmits,
+  endedOnError
+}) {
+  const kept = tokenPath !== null && initialPath.trim() !== "" && enteredPath === initialPath.trim();
+  const source = tokenPath === null ? null : kept ? "prefilled" : "typed";
+  const summary = [
+    `Import mode: ${importModeLabel(mode)}`,
+    tokenPath === null ? "Token file: none (went back)" : `Token file: ${tokenPath}`,
+    ...source ? [`Path source: ${source === "prefilled" ? "pre-filled, kept as is" : "typed by the user"}`] : [],
+    `Rejected paths: ${rejected.length}`,
+    ...rejected.map((attempt) => `  "${attempt.entered}" \u2192 ${attempt.error}`),
+    `Empty submits: ${emptySubmits}`,
+    ...endedOnError ? [`Went back while this error was showing: ${endedOnError}`] : []
+  ];
+  return {
+    summary,
+    data: {
+      import_mode: mode,
+      token_path: tokenPath,
+      path_source: source,
+      rejected_attempts: rejected,
+      empty_submits: emptySubmits,
+      ...endedOnError ? { error: endedOnError } : {}
+    }
+  };
+}
+
 // packages/experience-design-system-cli/src/tui/import/steps/02-token-input/validate-path.ts
 import { statSync as statSync5 } from "node:fs";
 
@@ -18376,20 +18421,29 @@ function TokenInputScreen({
   const [tokenPath, setTokenPath] = useState7(initialPath);
   const [failure, setFailure] = useState7(null);
   const rejected = useRef4([]).current;
+  const visit = useRef4({ emptySubmits: 0 }).current;
   useEffect7(() => {
-    startDebugRun({
-      flow: "import/token-input",
-      step: "02-token-input",
-      menuOption: "Token input",
-      inputs: { import_mode: mode, initial_path: initialPath }
-    });
+    startDebugRun({ flow: "import/token-input", step: "02-token-input", menuOption: "Token input" });
   }, []);
-  const back = () => {
+  const finish = (tokenPath2, enteredPath, endedOnError) => {
+    const { summary, data } = tokenInputLog({
+      mode,
+      tokenPath: tokenPath2,
+      enteredPath,
+      initialPath,
+      rejected,
+      emptySubmits: visit.emptySubmits,
+      endedOnError
+    });
     void finishDebugRun({
-      outputs: { token_path: null, rejected_attempts: rejected, ...failure ? { error: failure.error } : {} },
-      status: failure ? "error" : "success",
-      exitMethod: "discarded"
+      summary,
+      outputs: data,
+      status: endedOnError ? "error" : "success",
+      exitMethod: tokenPath2 ? "saved" : "discarded"
     });
+  };
+  const back = () => {
+    finish(null, tokenPath, failure?.error);
     onBack();
   };
   useTokenInputControls(back);
@@ -18410,7 +18464,8 @@ function TokenInputScreen({
   const submit = (value) => {
     const rawPath = toTokenPath(value);
     if (!rawPath) {
-      reject("", { error: "Enter the path to your token file." });
+      visit.emptySubmits += 1;
+      setFailure({ error: "Enter the path to your token file." });
       return;
     }
     const check = validateTokenPath(rawPath);
@@ -18418,15 +18473,7 @@ function TokenInputScreen({
       reject(rawPath, { error: check.error, resolvedPath: check.resolvedPath });
       return;
     }
-    void finishDebugRun({
-      outputs: {
-        token_path: check.path,
-        changed_from_initial: rawPath !== initialPath.trim(),
-        rejected_attempts: rejected
-      },
-      status: "success",
-      exitMethod: "saved"
-    });
+    finish(check.path, rawPath);
     onConfirm(check.path);
   };
   return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [

package/dist/index.js

@@ -19758,6 +19758,9 @@ var init_debug_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/00-preflight/logic.ts
+function importModeLabel(target) {
+  return IMPORT_TARGET_OPTIONS.find((option) => option.target === target).label;
+}
 function overviewFor(target) {
   return target === "tokens" ? TOKENS_ONLY_OVERVIEW : COMPONENTS_OVERVIEW;
 }
@@ -20154,9 +20157,8 @@ async function collectPreflightContext() {
 }
 function preflightLog(chosen, terminal, context) {
   const { columns, rows } = terminal;
-  const label = IMPORT_TARGET_OPTIONS.find((option) => option.target === chosen)?.label;
   const summary = [
-    label ? `Chose: ${label}` : "Left the import without choosing",
+    chosen ? `Chose: ${importModeLabel(chosen)}` : "Left the import without choosing",
     columns && rows ? `Terminal: ${columns} \xD7 ${rows}` : "Terminal: size unknown"
   ];
   if (context) {
@@ -20889,6 +20891,33 @@ var init_controls4 = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/import/steps/01-welcome/log.ts
+function welcomeLog({
+  mode,
+  projectPath,
+  initialPath,
+  emptySubmits
+}) {
+  const kept = projectPath !== null && initialPath.trim() !== "" && projectPath === initialPath.trim();
+  const source = projectPath === null ? null : kept ? "prefilled" : "typed";
+  const summary = [
+    `Import mode: ${importModeLabel(mode)}`,
+    projectPath === null ? "Project path: none (left the import)" : `Project path: ${projectPath}`,
+    ...source ? [`Path source: ${source === "prefilled" ? "pre-filled, kept as is" : "typed by the user"}`] : [],
+    `Empty submits: ${emptySubmits}`
+  ];
+  return {
+    summary,
+    data: { import_mode: mode, project_path: projectPath, path_source: source, empty_submits: emptySubmits }
+  };
+}
+var init_log2 = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/01-welcome/log.ts"() {
+    "use strict";
+    init_logic();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/steps/01-welcome/screen.tsx
 import { useEffect as useEffect6, useRef as useRef3, useState as useState6 } from "react";
 import { Box as Box10, Text as Text10 } from "ink";
@@ -20897,23 +20926,19 @@ function WelcomeScreen({ mode, onContinue, onQuit, initialPath = "" }) {
   const [projectPath, setProjectPath] = useState6(initialPath);
   const visit = useRef3({ emptySubmits: 0 }).current;
   useEffect6(() => {
-    startDebugRun({
-      flow: "import/welcome",
-      step: "01-welcome",
-      menuOption: "Welcome",
-      inputs: { import_mode: mode, initial_path: initialPath }
-    });
+    startDebugRun({ flow: "import/welcome", step: "01-welcome", menuOption: "Welcome" });
   }, []);
-  const quit = () => {
-    void finishDebugRun({
-      outputs: {
-        project_path: null,
-        typed_something: toProjectPath(projectPath) !== null,
-        empty_submits: visit.emptySubmits
-      },
-      status: "success",
-      exitMethod: "discarded"
+  const finish = (path5) => {
+    const { summary, data } = welcomeLog({
+      mode,
+      projectPath: path5,
+      initialPath,
+      emptySubmits: visit.emptySubmits
     });
+    void finishDebugRun({ summary, outputs: data, status: "success", exitMethod: path5 ? "saved" : "discarded" });
+  };
+  const quit = () => {
+    finish(null);
     onQuit();
   };
   useWelcomeControls(quit);
@@ -20923,15 +20948,7 @@ function WelcomeScreen({ mode, onContinue, onQuit, initialPath = "" }) {
       visit.emptySubmits += 1;
       return;
     }
-    void finishDebugRun({
-      outputs: {
-        project_path: path5,
-        changed_from_initial: path5 !== initialPath.trim(),
-        empty_submits: visit.emptySubmits
-      },
-      status: "success",
-      exitMethod: "saved"
-    });
+    finish(path5);
     onContinue(path5);
   };
   return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", children: [
@@ -20956,6 +20973,7 @@ var init_screen2 = __esm({
     init_debug_store();
     init_ClearableTextInput();
     init_controls4();
+    init_log2();
     init_logic5();
     init_ControlHints();
     init_StepHeader();
@@ -20996,6 +21014,46 @@ var init_controls5 = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/import/steps/02-token-input/log.ts
+function tokenInputLog({
+  mode,
+  tokenPath,
+  enteredPath,
+  initialPath,
+  rejected,
+  emptySubmits,
+  endedOnError
+}) {
+  const kept = tokenPath !== null && initialPath.trim() !== "" && enteredPath === initialPath.trim();
+  const source = tokenPath === null ? null : kept ? "prefilled" : "typed";
+  const summary = [
+    `Import mode: ${importModeLabel(mode)}`,
+    tokenPath === null ? "Token file: none (went back)" : `Token file: ${tokenPath}`,
+    ...source ? [`Path source: ${source === "prefilled" ? "pre-filled, kept as is" : "typed by the user"}`] : [],
+    `Rejected paths: ${rejected.length}`,
+    ...rejected.map((attempt) => `  "${attempt.entered}" \u2192 ${attempt.error}`),
+    `Empty submits: ${emptySubmits}`,
+    ...endedOnError ? [`Went back while this error was showing: ${endedOnError}`] : []
+  ];
+  return {
+    summary,
+    data: {
+      import_mode: mode,
+      token_path: tokenPath,
+      path_source: source,
+      rejected_attempts: rejected,
+      empty_submits: emptySubmits,
+      ...endedOnError ? { error: endedOnError } : {}
+    }
+  };
+}
+var init_log3 = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/02-token-input/log.ts"() {
+    "use strict";
+    init_logic();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/resolve-user-path.ts
 import { homedir as homedir3 } from "node:os";
 import { resolve as resolve21 } from "node:path";
@@ -21057,20 +21115,29 @@ function TokenInputScreen({
   const [tokenPath, setTokenPath] = useState7(initialPath);
   const [failure, setFailure] = useState7(null);
   const rejected = useRef4([]).current;
+  const visit = useRef4({ emptySubmits: 0 }).current;
   useEffect7(() => {
-    startDebugRun({
-      flow: "import/token-input",
-      step: "02-token-input",
-      menuOption: "Token input",
-      inputs: { import_mode: mode, initial_path: initialPath }
-    });
+    startDebugRun({ flow: "import/token-input", step: "02-token-input", menuOption: "Token input" });
   }, []);
-  const back = () => {
+  const finish = (tokenPath2, enteredPath, endedOnError) => {
+    const { summary, data } = tokenInputLog({
+      mode,
+      tokenPath: tokenPath2,
+      enteredPath,
+      initialPath,
+      rejected,
+      emptySubmits: visit.emptySubmits,
+      endedOnError
+    });
     void finishDebugRun({
-      outputs: { token_path: null, rejected_attempts: rejected, ...failure ? { error: failure.error } : {} },
-      status: failure ? "error" : "success",
-      exitMethod: "discarded"
+      summary,
+      outputs: data,
+      status: endedOnError ? "error" : "success",
+      exitMethod: tokenPath2 ? "saved" : "discarded"
     });
+  };
+  const back = () => {
+    finish(null, tokenPath, failure?.error);
     onBack();
   };
   useTokenInputControls(back);
@@ -21091,7 +21158,8 @@ function TokenInputScreen({
   const submit = (value) => {
     const rawPath = toTokenPath(value);
     if (!rawPath) {
-      reject("", { error: "Enter the path to your token file." });
+      visit.emptySubmits += 1;
+      setFailure({ error: "Enter the path to your token file." });
       return;
     }
     const check = validateTokenPath(rawPath);
@@ -21099,15 +21167,7 @@ function TokenInputScreen({
       reject(rawPath, { error: check.error, resolvedPath: check.resolvedPath });
       return;
     }
-    void finishDebugRun({
-      outputs: {
-        token_path: check.path,
-        changed_from_initial: rawPath !== initialPath.trim(),
-        rejected_attempts: rejected
-      },
-      status: "success",
-      exitMethod: "saved"
-    });
+    finish(check.path, rawPath);
     onConfirm(check.path);
   };
   return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [
@@ -21144,6 +21204,7 @@ var init_screen3 = __esm({
     init_debug_store();
     init_ClearableTextInput();
     init_controls5();
+    init_log3();
     init_logic6();
     init_validate_path();
     init_ControlHints();
@@ -22745,7 +22806,7 @@ function scopeGateLogOutputs(components, decisions) {
   };
 }
 var MAX_NAMES, capped;
-var init_log2 = __esm({
+var init_log4 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/07-scope-gate/log.ts"() {
     "use strict";
     MAX_NAMES = 20;
@@ -25644,7 +25705,7 @@ var init_screen8 = __esm({
     "use strict";
     init_debug_store();
     init_StepHeader();
-    init_log2();
+    init_log4();
     init_tokens_column();
     init_load();
     init_logic10();

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.43.1-dev-build-b2134432.0",
+  "version": "2.43.1-dev-build-1205d418.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/import/steps/00-preflight/logic.d.ts

@@ -4,6 +4,8 @@ export declare const IMPORT_TARGET_OPTIONS: ReadonlyArray<{
     target: ImportTarget;
     label: string;
 }>;
+/** The words the user saw for a choice. The logs of the steps after the preflight say it, since it decides which steps run. */
+export declare function importModeLabel(target: ImportTarget): string;
 export declare function overviewFor(target: ImportTarget): readonly OverviewStep[];
 export type ImportStepId = 'project' | 'token-file' | 'path-validation' | 'credentials' | 'component-extraction' | 'token-generation' | 'scope-gate' | 'generation' | 'review' | 'save-push';
 export declare function stepsFor(target: ImportTarget): readonly ImportStepId[];

package/dist/src/tui/import/steps/01-welcome/log.d.ts

@@ -0,0 +1,13 @@
+import { type ImportTarget } from '../00-preflight/logic.js';
+/** The log's two sections: `summary` for a person, `data` for AI, both carrying the same facts. */
+export declare function welcomeLog({ mode, projectPath, initialPath, emptySubmits, }: {
+    mode: ImportTarget;
+    /** The path the user continued with, or null when they left the import. */
+    projectPath: string | null;
+    initialPath: string;
+    /** How many times Enter was pressed on an empty field, which does nothing and can look like a stuck screen. */
+    emptySubmits: number;
+}): {
+    summary: string[];
+    data: Record<string, unknown>;
+};

package/dist/src/tui/import/steps/02-token-input/log.d.ts

@@ -0,0 +1,24 @@
+import { type ImportTarget } from '../00-preflight/logic.js';
+/** A path that was turned down, as typed, with the reason the user was shown. */
+export type RejectedAttempt = {
+    entered: string;
+    error: string;
+    resolved_path?: string;
+};
+/** The log's two sections: `summary` for a person, `data` for AI, both carrying the same facts. */
+export declare function tokenInputLog({ mode, tokenPath, enteredPath, initialPath, rejected, emptySubmits, endedOnError, }: {
+    mode: ImportTarget;
+    /** The token file the user continued with, or null when they went back. */
+    tokenPath: string | null;
+    /** What they typed to get there, before it was resolved. */
+    enteredPath: string;
+    initialPath: string;
+    rejected: readonly RejectedAttempt[];
+    /** How many times Enter was pressed on an empty field. Counted apart from the rejected paths. */
+    emptySubmits: number;
+    /** The error still showing when the user went back, if there was one. */
+    endedOnError: string | undefined;
+}): {
+    summary: string[];
+    data: Record<string, unknown>;
+};

package/dist/src/tui/import/steps/07-scope-gate/use-scope-gate.d.ts

@@ -31,7 +31,7 @@ export declare function useScopeGate({ components, tokenCount, tokensWidth, onCo
     emptyMessage: string | undefined;
     safeCursor: number;
     scrollOffset: number;
-    selectionStateByKey: Map<string, "accepted" | "rejected" | "undecided">;
+    selectionStateByKey: Map<string, "rejected" | "accepted" | "undecided">;
     aiFlaggedByKey: Map<string, boolean>;
     dimPredicate: ((componentKey: string) => boolean) | undefined;
     columnOneView: "flat" | "grouped";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.43.1-dev-build-b2134432.0",
+  "version": "2.43.1-dev-build-1205d418.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,7 +45,7 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-types": "2.43.1-dev-build-b2134432.0"
+    "@contentful/experience-design-system-types": "2.43.1-dev-build-1205d418.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -59,7 +59,7 @@
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16",
-    "@contentful/experience-design-system-backend-pipeline": "2.43.1-dev-build-b2134432.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.43.1-dev-build-1205d418.0"
   },
   "repository": {
     "type": "git",