@contentful/experience-design-system-cli 2.40.1-dev-build-b9f92429.0 → 2.40.1-dev-build-54dd0c33.0

package/dist/app.js

@@ -3437,6 +3437,7 @@ function TokenInputScreen({
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/screen.tsx
 import { useEffect as useEffect7, useMemo, useState as useState7 } from "react";
 import { Box as Box12, Text as Text12 } from "ink";
+init_debug_store();
 
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/controls.ts
 import { useInput as useInput9 } from "ink";
@@ -3497,6 +3498,19 @@ function summarize(counts, { hasTokens = true } = {}) {
     warning: hasTokens ? "No component or token files found. Try a different path." : "No component files found. Try a different path."
   };
 }
+function scanReport(scan, path5, { hasTokens = true } = {}) {
+  if (scan === void 0) return { scan: "unfinished" };
+  if (!scan.ok) return { scan: "failed", failure: scan.failure, error: describeFailure(scan.failure, path5).headline };
+  const { total, warning } = summarize(scan.counts, { hasTokens });
+  const { total: _total, ...byType } = scan.counts;
+  return {
+    scan: "ok",
+    files_found: total,
+    counts: Object.fromEntries(Object.entries(byType).filter(([, count]) => count > 0)),
+    ...warning ? { warning } : {},
+    ...scan.warnings.length > 0 ? { scan_warnings: scan.warnings } : {}
+  };
+}
 function phaseOf(scan) {
   if (scan === void 0) return "scanning";
   return scan.ok ? "ready" : "failed";
@@ -18084,6 +18098,7 @@ function Summary({
   ] });
 }
 function PathValidationScreen({
+  mode,
   projectPath,
   onConfirm,
   onChangePath,
@@ -18092,16 +18107,39 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState7();
+  useEffect7(() => {
+    startDebugRun({
+      flow: "import/path-validation",
+      step: "03-path-validation",
+      menuOption: "Path validation",
+      inputs: { import_mode: mode, project_path: projectPath, resolved_path: resolvedPath }
+    });
+  }, []);
   useEffect7(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
+  const finish = (outcome, exitMethod) => {
+    void finishDebugRun({
+      outputs: { outcome, ...scanReport(scan, resolvedPath, { hasTokens }) },
+      status: scan?.ok === false ? "error" : "success",
+      exitMethod
+    });
+  };
   usePathValidationControls(phase, {
     onConfirm: () => {
-      if (scan?.ok) onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
+      if (!scan?.ok) return;
+      finish("continued", "saved");
+      onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
     },
-    onChangePath,
-    onBack
+    onChangePath: () => {
+      finish("changed-path", "discarded");
+      onChangePath();
+    },
+    onBack: () => {
+      finish("back", "discarded");
+      onBack();
+    }
   });
   return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx13(StepHeader, { step: "setup" }),
@@ -31085,6 +31123,7 @@ function App({ importOptions, inkClear }) {
               return /* @__PURE__ */ jsx66(
                 PathValidationScreen,
                 {
+                  mode: target,
                   projectPath: answers.projectPath ?? "",
                   hasTokens: target !== "components",
                   onConfirm: ({ filePaths }) => answer({ scannedFiles: filePaths }),

package/dist/index.js

@@ -20672,6 +20672,19 @@ function summarize(counts, { hasTokens = true } = {}) {
     warning: hasTokens ? "No component or token files found. Try a different path." : "No component files found. Try a different path."
   };
 }
+function scanReport(scan, path5, { hasTokens = true } = {}) {
+  if (scan === void 0) return { scan: "unfinished" };
+  if (!scan.ok) return { scan: "failed", failure: scan.failure, error: describeFailure(scan.failure, path5).headline };
+  const { total, warning } = summarize(scan.counts, { hasTokens });
+  const { total: _total, ...byType } = scan.counts;
+  return {
+    scan: "ok",
+    files_found: total,
+    counts: Object.fromEntries(Object.entries(byType).filter(([, count]) => count > 0)),
+    ...warning ? { warning } : {},
+    ...scan.warnings.length > 0 ? { scan_warnings: scan.warnings } : {}
+  };
+}
 function phaseOf(scan) {
   if (scan === void 0) return "scanning";
   return scan.ok ? "ready" : "failed";
@@ -20810,6 +20823,7 @@ function Summary({
   ] });
 }
 function PathValidationScreen({
+  mode,
   projectPath,
   onConfirm,
   onChangePath,
@@ -20818,16 +20832,39 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState7();
+  useEffect7(() => {
+    startDebugRun({
+      flow: "import/path-validation",
+      step: "03-path-validation",
+      menuOption: "Path validation",
+      inputs: { import_mode: mode, project_path: projectPath, resolved_path: resolvedPath }
+    });
+  }, []);
   useEffect7(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
+  const finish = (outcome, exitMethod) => {
+    void finishDebugRun({
+      outputs: { outcome, ...scanReport(scan, resolvedPath, { hasTokens }) },
+      status: scan?.ok === false ? "error" : "success",
+      exitMethod
+    });
+  };
   usePathValidationControls(phase, {
     onConfirm: () => {
-      if (scan?.ok) onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
+      if (!scan?.ok) return;
+      finish("continued", "saved");
+      onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
+    },
+    onChangePath: () => {
+      finish("changed-path", "discarded");
+      onChangePath();
     },
-    onChangePath,
-    onBack
+    onBack: () => {
+      finish("back", "discarded");
+      onBack();
+    }
   });
   return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx13(StepHeader, { step: "setup" }),
@@ -20847,6 +20884,7 @@ var init_screen4 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/screen.tsx"() {
     "use strict";
     init_theme();
+    init_debug_store();
     init_resolve_user_path();
     init_controls6();
     init_scan_files();
@@ -34903,6 +34941,7 @@ function App({ importOptions, inkClear }) {
               return /* @__PURE__ */ jsx66(
                 PathValidationScreen,
                 {
+                  mode: target,
                   projectPath: answers.projectPath ?? "",
                   hasTokens: target !== "components",
                   onConfirm: ({ filePaths }) => answer({ scannedFiles: filePaths }),

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.40.1-dev-build-b9f92429.0",
+  "version": "2.40.1-dev-build-54dd0c33.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/import/steps/03-path-validation/logic.d.ts

@@ -40,6 +40,14 @@ export declare function describeFailure(failure: ScanFailureCode, path: string):
 export declare function summarize(counts: FileCounts, { hasTokens }?: {
     hasTokens?: boolean;
 }): Summary;
+/**
+ * What the debug log says about a scan: the counts and warnings when it worked, or the failure and the message the user
+ * saw when it did not. File paths are left out, since a project can have thousands; the counts are what show whether
+ * the scan found the components.
+ */
+export declare function scanReport(scan: ScanResult | undefined, path: string, { hasTokens }?: {
+    hasTokens?: boolean;
+}): Record<string, unknown>;
 export declare function phaseOf(scan: ScanResult | undefined): PathPhase;
 export declare function keyAction(phase: PathPhase, input: string, key: Key): KeyAction | undefined;
 export {};

package/dist/src/tui/import/steps/03-path-validation/screen.d.ts

@@ -1,5 +1,8 @@
 import React from 'react';
+import type { ImportTarget } from '../00-preflight/logic.js';
 interface PathValidationScreenProps {
+    /** What the user chose to import at Preflight; it decides which steps run, so every log notes it. */
+    mode: ImportTarget;
     projectPath: string;
     onConfirm: (result: {
         projectPath: string;
@@ -10,5 +13,5 @@ interface PathValidationScreenProps {
     /** False when the import does not generate tokens, so `.json` files are not described as design tokens. */
     hasTokens?: boolean;
 }
-export declare function PathValidationScreen({ projectPath, onConfirm, onChangePath, onBack, hasTokens, }: PathValidationScreenProps): React.ReactElement;
+export declare function PathValidationScreen({ mode, projectPath, onConfirm, onChangePath, onBack, hasTokens, }: PathValidationScreenProps): React.ReactElement;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.40.1-dev-build-b9f92429.0",
+  "version": "2.40.1-dev-build-54dd0c33.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.40.1-dev-build-b9f92429.0"
+    "@contentful/experience-design-system-types": "2.40.1-dev-build-54dd0c33.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.40.1-dev-build-b9f92429.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.40.1-dev-build-54dd0c33.0"
   },
   "repository": {
     "type": "git",