@contentful/experience-design-system-cli 2.35.1-dev-build-d5a8fc4d.0 → 2.35.1-dev-build-57c625cc.0

package/legacy/dist/src/index.js

@@ -1213,8 +1213,8 @@ function makeSessionTimestamp() {
   const override = process.env["EDSI_DEBUG_TS"];
   if (override) return override;
   const now = /* @__PURE__ */ new Date();
-  const pad = (n, w = 2) => n.toString().padStart(w, "0");
-  return `${now.getUTCFullYear()}${pad(now.getUTCMonth() + 1)}${pad(now.getUTCDate())}T${pad(now.getUTCHours())}${pad(now.getUTCMinutes())}${pad(now.getUTCSeconds())}Z`;
+  const pad3 = (n, w = 2) => n.toString().padStart(w, "0");
+  return `${now.getUTCFullYear()}${pad3(now.getUTCMonth() + 1)}${pad3(now.getUTCDate())}T${pad3(now.getUTCHours())}${pad3(now.getUTCMinutes())}${pad3(now.getUTCSeconds())}Z`;
 }
 function initDebugLogger(opts) {
   if (singleton) return singleton;
@@ -2011,8 +2011,8 @@ function deleteRawTokensForSession(db, sessionId2) {
 }
 function createRawTokenGroups(db, sessionId2, groups) {
   const insertGroup = db.prepare(`INSERT INTO raw_token_groups (session_id, path, description) VALUES (?, ?, ?)`);
-  for (const group of groups) {
-    insertGroup.run(sessionId2, group.path, group.$description ?? null);
+  for (const group2 of groups) {
+    insertGroup.run(sessionId2, group2.path, group2.$description ?? null);
   }
 }
 function createRawTokens(db, sessionId2, tokens) {
@@ -6891,24 +6891,24 @@ function parseEdsiError(rawInput) {
     }
   }
   const cleaned = stripLambdaLogPrefix(body);
-  const json = parseJsonBody(cleaned) ?? parseJsonBody(body);
-  const bindingFromJson = typeof json?.message === "string" ? parseBindingDiagnostics(json.message) : null;
+  const json2 = parseJsonBody(cleaned) ?? parseJsonBody(body);
+  const bindingFromJson = typeof json2?.message === "string" ? parseBindingDiagnostics(json2.message) : null;
   if (bindingFromJson) {
     return {
-      code: bindingFromJson.code ?? json?.code ?? null,
+      code: bindingFromJson.code ?? json2?.code ?? null,
       message: bindingFromJson.message ?? cleaned,
       cycle: null,
       raw: false,
       ...bindingFromJson.diagnostics ? { diagnostics: bindingFromJson.diagnostics } : {}
     };
   }
-  if (json && (json.code || json.message || json.cycle)) {
+  if (json2 && (json2.code || json2.message || json2.cycle)) {
     return {
-      code: json.code ?? null,
-      message: json.message ?? (cleaned || prefix),
-      cycle: json.cycle ?? null,
+      code: json2.code ?? null,
+      message: json2.message ?? (cleaned || prefix),
+      cycle: json2.cycle ?? null,
       raw: false,
-      ...json.diagnostics ? { diagnostics: json.diagnostics } : {}
+      ...json2.diagnostics ? { diagnostics: json2.diagnostics } : {}
     };
   }
   const binding = parseBindingDiagnostics(cleaned);
@@ -8448,8 +8448,8 @@ async function resolveSession(sessionFlag, command) {
 }
 function rebuildDTCGTree(groups, tokens) {
   const root = {};
-  for (const group of groups) {
-    const segments = group.path.split(".");
+  for (const group2 of groups) {
+    const segments = group2.path.split(".");
     let node = root;
     for (const seg of segments) {
       if (typeof node[seg] !== "object" || node[seg] === null) {
@@ -8457,8 +8457,8 @@ function rebuildDTCGTree(groups, tokens) {
       }
       node = node[seg];
     }
-    if (group.$description) {
-      node["$description"] = group.$description;
+    if (group2.$description) {
+      node["$description"] = group2.$description;
     }
   }
   for (const token of tokens) {
@@ -9201,6 +9201,214 @@ var init_run_teaser = __esm({
   }
 });
 
+// packages/experience-design-system-cli-legacy/src/lib/push-debug-log.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readdirSync, writeFileSync } from "node:fs";
+import { join as join10 } from "node:path";
+function scrub(key, value) {
+  if (/^cma_?token$/i.test(key)) {
+    return typeof value === "string" && value ? `[present, ${value.length} chars]` : "[not set]";
+  }
+  if (typeof value === "string" && SECRET_VALUE.test(value)) return "[redacted]";
+  return value;
+}
+function json(value) {
+  const text = JSON.stringify(value, scrub, 2) ?? "null";
+  return text.length > MAX_BLOCK_CHARS ? `${text.slice(0, MAX_BLOCK_CHARS)}
+\u2026 truncated, ${text.length - MAX_BLOCK_CHARS} more characters` : text;
+}
+function pad(n, width = 2) {
+  return String(n).padStart(width, "0");
+}
+function datePrefix(now) {
+  return `${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${now.getFullYear()}`;
+}
+function clock(now) {
+  return `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}.${pad(now.getMilliseconds(), 3)}`;
+}
+function nextFilename(dir, now) {
+  const today = datePrefix(now);
+  const pattern = new RegExp(`^${today}-push-attempt-(\\d+)\\.md$`);
+  const existing = existsSync3(dir) ? readdirSync(dir) : [];
+  const max = existing.reduce((acc, entry) => {
+    const match2 = pattern.exec(entry);
+    return match2 ? Math.max(acc, Number(match2[1])) : acc;
+  }, 0);
+  return `${today}-push-attempt-${max + 1}.md`;
+}
+function entityName(entry) {
+  if (typeof entry === "string") return entry;
+  if (entry && typeof entry === "object") {
+    const record = entry;
+    for (const field of ["key", "name", "$name", "id"]) {
+      if (typeof record[field] === "string") return record[field];
+    }
+    const current = record["current"];
+    if (current && typeof current === "object" && typeof current["name"] === "string") {
+      return current["name"];
+    }
+  }
+  return "unknown";
+}
+function group(diff) {
+  return {
+    new: diff.new.map(entityName),
+    changed: diff.changed.map((entry) => {
+      const breaking = entry && typeof entry === "object" && entry.changeClassification?.classification === "breaking";
+      return breaking ? `${entityName(entry)} (breaking)` : entityName(entry);
+    }),
+    unchanged: diff.unchanged,
+    removed: diff.removed.map(entityName)
+  };
+}
+function summarizePreview(preview) {
+  return { components: group(preview.components), tokens: group(preview.tokens) };
+}
+function summarizeCdf(cdf) {
+  return Object.entries(cdf).filter(([key]) => !key.startsWith("$") && key !== "allowDeletions").map(([key, value]) => {
+    const entry = value ?? {};
+    const properties = entry["$properties"];
+    const slots = entry["$slots"];
+    return {
+      name: key,
+      type: entry["$type"],
+      properties: properties && typeof properties === "object" ? Object.keys(properties) : [],
+      slots: slots && typeof slots === "object" ? Object.keys(slots) : []
+    };
+  });
+}
+function renderEvents(events) {
+  if (events.length === 0) return "_Nothing recorded yet._";
+  return events.map((event, index) => {
+    const note = event.note ? ` \u2014 ${event.note}` : "";
+    const request2 = event.requestId ? ` _(request ${event.requestId})_` : "";
+    return `${index + 1}. \`${clock(event.at)}\` (+${event.sinceStartMs}ms) **${event.title}**${note}${request2}`;
+  }).join("\n");
+}
+function renderDetails(events) {
+  const withData = events.map((event, index) => ({ event, index })).filter(({ event }) => event.data && Object.keys(event.data).length > 0);
+  if (withData.length === 0) return "";
+  return withData.map(
+    ({ event, index }) => `<details>
+<summary>${index + 1}. ${event.title}</summary>
+
+\`\`\`json
+${json(event.data)}
+\`\`\`
+
+</details>`
+  ).join("\n\n");
+}
+function render2(runId, inputs, events, startedAt, result, durationMs) {
+  const requestIds = [...new Set(events.map((event) => event.requestId).filter(Boolean))];
+  const text = (field) => String(inputs[field] ?? "\u2014");
+  const details = renderDetails(events);
+  return `# Push to Contentful \u2014 debug log
+
+## Summary
+
+| | |
+|---|---|
+| **Result** | ${OUTCOME_LABEL[result.outcome]} |
+| **What happened** | ${result.summary} |
+| **Space / environment** | \`${text("space_id")}\` / \`${text("environment_id")}\` |
+| **Host** | ${text("host")} |
+| **Started** | ${startedAt.toISOString()} |
+| **Duration** | ${durationMs}ms |
+| **Request IDs** | ${requestIds.length > 0 ? requestIds.map((id) => `\`${id}\``).join(", ") : "\u2014"} |
+| **CLI / runtime** | ${cliVersion()} \xB7 ${process.platform} \xB7 Node ${process.version} |
+| **Run ID** | ${runId} |
+
+## Timeline
+
+${renderEvents(events)}
+
+## Inputs
+
+\`\`\`json
+${json(inputs)}
+\`\`\`
+
+## Result
+
+\`\`\`json
+${json({ outcome: result.outcome, summary: result.summary, ...result.details ?? {} })}
+\`\`\`
+${details ? `
+## Details
+
+${details}
+` : ""}`;
+}
+function startPushDebugRun(inputs) {
+  const sessionDir = process.env[DEBUG_SESSION_DIR_ENV];
+  if (!sessionDir) return NOOP_RUN;
+  const startedAt = /* @__PURE__ */ new Date();
+  const runId = `${startedAt.getFullYear()}${pad(startedAt.getMonth() + 1)}${pad(startedAt.getDate())}-${pad(startedAt.getHours())}${pad(startedAt.getMinutes())}${pad(startedAt.getSeconds())}`;
+  const events = [];
+  let result = {
+    outcome: "in-progress",
+    summary: "The push started but no final result was recorded."
+  };
+  let finished = false;
+  let path;
+  const flush = () => {
+    try {
+      if (!path) {
+        const dir = join10(sessionDir, "import");
+        mkdirSync3(dir, { recursive: true });
+        path = join10(dir, nextFilename(dir, startedAt));
+      }
+      writeFileSync(path, render2(runId, inputs, events, startedAt, result, Date.now() - startedAt.getTime()), {
+        mode: 384
+      });
+    } catch {
+    }
+  };
+  flush();
+  return {
+    event(title, options = {}) {
+      if (finished) return;
+      const at = /* @__PURE__ */ new Date();
+      events.push({ at, sinceStartMs: at.getTime() - startedAt.getTime(), title, ...options });
+      flush();
+    },
+    finish(final) {
+      if (finished) return;
+      finished = true;
+      result = final;
+      const at = /* @__PURE__ */ new Date();
+      events.push({
+        at,
+        sinceStartMs: at.getTime() - startedAt.getTime(),
+        title: OUTCOME_LABEL[final.outcome].replace(/^\S+\s/, ""),
+        note: final.summary
+      });
+      flush();
+    }
+  };
+}
+var DEBUG_SESSION_DIR_ENV, NOOP_RUN, OUTCOME_LABEL, MAX_BLOCK_CHARS, SECRET_VALUE;
+var init_push_debug_log = __esm({
+  "packages/experience-design-system-cli-legacy/src/lib/push-debug-log.ts"() {
+    "use strict";
+    init_client();
+    DEBUG_SESSION_DIR_ENV = "EDS_DEBUG_SESSION_DIR";
+    NOOP_RUN = { event: () => void 0, finish: () => void 0 };
+    OUTCOME_LABEL = {
+      "in-progress": "\u23F3 In progress (the process ended before the push finished)",
+      pushed: "\u2705 Pushed",
+      partial: "\u26A0\uFE0F Partly pushed (some items failed)",
+      failed: "\u274C Push failed",
+      "preview-failed": "\u274C Preview failed (nothing was sent to apply)",
+      "nothing-to-push": "\u2139\uFE0F Nothing to push (the server says the space already matches)",
+      skipped: "\u23ED\uFE0F Skipped",
+      superseded: "\u21A9\uFE0F Superseded by a newer attempt"
+    };
+    MAX_BLOCK_CHARS = 1e5;
+    SECRET_VALUE = /CFPAT-[A-Za-z0-9_-]{20,}|^Bearer\s+\S+/;
+  }
+});
+
 // packages/experience-design-system-cli-legacy/src/tui/use-blinking-cursor.ts
 import { useEffect as useEffect2, useState as useState3 } from "react";
 function useBlinkingCursor() {
@@ -9220,8 +9428,8 @@ var init_use_blinking_cursor = __esm({
 // packages/experience-design-system-cli-legacy/src/runs/path-prompt.tsx
 import { useState as useState4 } from "react";
 import { Box as Box6, Text as Text7 } from "ink";
-import { readdirSync } from "node:fs";
-import { dirname as dirname5, basename as basename2, join as join10 } from "node:path";
+import { readdirSync as readdirSync2 } from "node:fs";
+import { dirname as dirname5, basename as basename2, join as join11 } from "node:path";
 import { jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
 function autocomplete(partial) {
   if (!partial) return null;
@@ -9230,19 +9438,19 @@ function autocomplete(partial) {
   const base = basename2(normalized);
   let entries;
   try {
-    entries = readdirSync(dir);
+    entries = readdirSync2(dir);
   } catch {
     return null;
   }
   const matches = entries.filter((e) => e.startsWith(base));
   if (matches.length === 0) return null;
-  if (matches.length === 1) return join10(dir, matches[0]);
+  if (matches.length === 1) return join11(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 ? join10(dir, prefix) : null;
+  return prefix.length > base.length ? join11(dir, prefix) : null;
 }
 function PathPrompt({
   defaultPath,
@@ -9307,12 +9515,12 @@ var init_path_prompt = __esm({
 
 // packages/experience-design-system-cli-legacy/src/runs/save-path-resolver.ts
 import { access as access4 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 async function listConflictingFiles(path) {
   const conflicts = [];
   for (const name of SAVE_FILES) {
     try {
-      await access4(join11(path, name));
+      await access4(join12(path, name));
       conflicts.push(name);
     } catch {
     }
@@ -9332,7 +9540,7 @@ function buildTimestampedSubdir(base, now = /* @__PURE__ */ new Date()) {
   const hh = pad2(now.getHours());
   const mm = pad2(now.getMinutes());
   const ss = pad2(now.getSeconds());
-  return join11(base, `dsi-${y}${m}${d}-${hh}${mm}${ss}`);
+  return join12(base, `dsi-${y}${m}${d}-${hh}${mm}${ss}`);
 }
 var SAVE_FILES;
 var init_save_path_resolver = __esm({
@@ -9344,7 +9552,7 @@ var init_save_path_resolver = __esm({
 
 // packages/experience-design-system-cli-legacy/src/runs/store.ts
 import { readFile as readFile12, writeFile as writeFile4, mkdir as mkdir4, rename } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 import { homedir as homedir6 } from "node:os";
 import { randomBytes as randomBytes2 } from "node:crypto";
 function encodeBase32(bytes, length) {
@@ -9440,8 +9648,8 @@ var init_store = __esm({
     RUNS_FILE_VERSION = 3;
     RUNS_FILE_CAP = 200;
     READABLE_VERSIONS = /* @__PURE__ */ new Set([1, 2, 3]);
-    RUNS_DIR = join12(homedir6(), ".config", "experiences");
-    RUNS_PATH = join12(RUNS_DIR, "runs.json");
+    RUNS_DIR = join13(homedir6(), ".config", "experiences");
+    RUNS_PATH = join13(RUNS_DIR, "runs.json");
     CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
   }
 });
@@ -9598,7 +9806,7 @@ var init_WelcomeStep = __esm({
 import { useState as useState6, useEffect as useEffect3 } from "react";
 import { Box as Box9, Text as Text10 } from "ink";
 import { promises as fs } from "node:fs";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 import { jsx as jsx12, jsxs as jsxs9 } from "react/jsx-runtime";
 async function countFiles(dir) {
   const counts = {
@@ -9622,7 +9830,7 @@ async function countFiles(dir) {
     await Promise.all(
       entries.map(async (entry) => {
         if (IGNORE_DIRS.has(entry)) return;
-        const full = join13(current, entry);
+        const full = join14(current, entry);
         let stat7;
         try {
           stat7 = await fs.stat(full);
@@ -11307,8 +11515,8 @@ var init_types = __esm({
 });
 
 // packages/experience-design-system-extraction/dist/src/extract/tsx-shared.js
-import { existsSync as existsSync3, readFileSync as readFileSync5 } from "node:fs";
-import { dirname as dirname6, join as join14, resolve as resolve12 } from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync5 } from "node:fs";
+import { dirname as dirname6, join as join15, resolve as resolve12 } from "node:path";
 import { Node, Project, SyntaxKind } from "ts-morph";
 import ts from "typescript";
 function createTsxProject(filePaths) {
@@ -11507,8 +11715,8 @@ function findNearestTsConfigPath(filePath) {
   let currentDir = dirname6(filePath);
   while (true) {
     for (const candidateName of ["tsconfig.json", "jsconfig.json"]) {
-      const candidatePath = join14(currentDir, candidateName);
-      if (existsSync3(candidatePath)) {
+      const candidatePath = join15(currentDir, candidateName);
+      if (existsSync4(candidatePath)) {
         nearestTsConfigPathCache.set(filePath, candidatePath);
         return candidatePath;
       }
@@ -11564,12 +11772,12 @@ function resolveImportSourcePath(basePath) {
     `${basePath}.tsx`,
     `${basePath}.js`,
     `${basePath}.jsx`,
-    join14(basePath, "index.ts"),
-    join14(basePath, "index.tsx"),
-    join14(basePath, "index.js"),
-    join14(basePath, "index.jsx")
+    join15(basePath, "index.ts"),
+    join15(basePath, "index.tsx"),
+    join15(basePath, "index.js"),
+    join15(basePath, "index.jsx")
   ];
-  return candidates.find((candidatePath) => existsSync3(candidatePath));
+  return candidates.find((candidatePath) => existsSync4(candidatePath));
 }
 function findProjectSourceFileByImportPath(project, resolvedPath) {
   const candidatePaths = [
@@ -11578,10 +11786,10 @@ function findProjectSourceFileByImportPath(project, resolvedPath) {
     `${resolvedPath}.tsx`,
     `${resolvedPath}.js`,
     `${resolvedPath}.jsx`,
-    join14(resolvedPath, "index.ts"),
-    join14(resolvedPath, "index.tsx"),
-    join14(resolvedPath, "index.js"),
-    join14(resolvedPath, "index.jsx")
+    join15(resolvedPath, "index.ts"),
+    join15(resolvedPath, "index.tsx"),
+    join15(resolvedPath, "index.js"),
+    join15(resolvedPath, "index.jsx")
   ];
   for (const candidatePath of candidatePaths) {
     const sourceFile = project.getSourceFile(candidatePath);
@@ -11602,10 +11810,10 @@ function findWorkspacePackageEntrySourceFile(originSourceFile, moduleSpecifier)
   if (!packageRootDir)
     return void 0;
   const preferredEntryPaths = [
-    join14(packageRootDir, "src/index.ts"),
-    join14(packageRootDir, "src/index.tsx"),
-    join14(packageRootDir, "index.ts"),
-    join14(packageRootDir, "index.tsx")
+    join15(packageRootDir, "src/index.ts"),
+    join15(packageRootDir, "src/index.tsx"),
+    join15(packageRootDir, "index.ts"),
+    join15(packageRootDir, "index.tsx")
   ];
   for (const entryPath of preferredEntryPaths) {
     const entrySourceFile = project.getSourceFile(entryPath);
@@ -11613,7 +11821,7 @@ function findWorkspacePackageEntrySourceFile(originSourceFile, moduleSpecifier)
       return entrySourceFile;
     }
   }
-  return candidateSourceFiles.find((sourceFile) => sourceFile.getDirectoryPath() === join14(packageRootDir, "src"));
+  return candidateSourceFiles.find((sourceFile) => sourceFile.getDirectoryPath() === join15(packageRootDir, "src"));
 }
 function getWorkspacePackageManifestForSourceFile(sourceFile) {
   const packageRootDir = findNearestPackageRootDir(sourceFile.getFilePath());
@@ -11622,7 +11830,7 @@ function getWorkspacePackageManifestForSourceFile(sourceFile) {
   if (workspacePackageManifestCache.has(packageRootDir)) {
     return workspacePackageManifestCache.get(packageRootDir) ?? void 0;
   }
-  const packageJsonPath = join14(packageRootDir, "package.json");
+  const packageJsonPath = join15(packageRootDir, "package.json");
   try {
     const packageJson = JSON.parse(readFileSync5(packageJsonPath, "utf8"));
     const manifest = typeof packageJson.name === "string" ? { name: packageJson.name, rootDir: packageRootDir } : null;
@@ -11639,7 +11847,7 @@ function findNearestPackageRootDir(filePath) {
   }
   let currentDir = dirname6(filePath);
   while (true) {
-    if (existsSync3(join14(currentDir, "package.json"))) {
+    if (existsSync4(join15(currentDir, "package.json"))) {
       packageRootByFilePathCache.set(filePath, currentDir);
       return currentDir;
     }
@@ -14701,8 +14909,8 @@ var init_vue_tsx = __esm({
 });
 
 // packages/experience-design-system-extraction/dist/src/extract/resolve-local-module.js
-import { existsSync as existsSync4, statSync as statSync2 } from "node:fs";
-import { dirname as dirname7, join as join15, resolve as resolve13 } from "node:path";
+import { existsSync as existsSync5, statSync as statSync2 } from "node:fs";
+import { dirname as dirname7, join as join16, resolve as resolve13 } from "node:path";
 function resolveLocalModule(importingFilePath, specifier, options = {}) {
   const basePath = resolve13(dirname7(importingFilePath), specifier);
   const candidates = [
@@ -14711,18 +14919,18 @@ function resolveLocalModule(importingFilePath, specifier, options = {}) {
     `${basePath}.ts`,
     `${basePath}.mjs`,
     `${basePath}.cjs`,
-    join15(basePath, "index.js"),
-    join15(basePath, "index.ts"),
-    join15(basePath, "index.mjs"),
-    join15(basePath, "index.cjs")
+    join16(basePath, "index.js"),
+    join16(basePath, "index.ts"),
+    join16(basePath, "index.mjs"),
+    join16(basePath, "index.cjs")
   ];
   for (const candidate of candidates) {
-    if (existsSync4(candidate) && statSync2(candidate).isFile())
+    if (existsSync5(candidate) && statSync2(candidate).isFile())
       return candidate;
   }
   if (options.allowJavaScriptExtensionFallback && basePath.endsWith(".js")) {
     const tsPath = `${basePath.slice(0, -".js".length)}.ts`;
-    if (existsSync4(tsPath) && statSync2(tsPath).isFile())
+    if (existsSync5(tsPath) && statSync2(tsPath).isFile())
       return tsPath;
   }
   return null;
@@ -14753,9 +14961,9 @@ var init_resolve_type_property = __esm({
 
 // packages/experience-design-system-extraction/dist/src/extract/vue.js
 import os from "node:os";
-import { basename as basename3, dirname as dirname8, resolve as resolve14, join as join16 } from "node:path";
+import { basename as basename3, dirname as dirname8, resolve as resolve14, join as join17 } from "node:path";
 import { readFile as readFile15 } from "node:fs/promises";
-import { existsSync as existsSync5, readFileSync as readFileSync6, readdirSync as readdirSync2, statSync as statSync3 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6, readdirSync as readdirSync3, statSync as statSync3 } from "node:fs";
 import { parse as parseSFC } from "@vue/compiler-sfc";
 import { Project as Project3, Node as Node6 } from "ts-morph";
 async function extractVueComponents(filePaths, onProgress) {
@@ -14968,11 +15176,11 @@ function findWorkspaceRoot(startDir) {
     return workspaceRootCache.get(startDir);
   let dir = startDir;
   while (true) {
-    const pkgJsonPath = join16(dir, "package.json");
-    if (existsSync5(pkgJsonPath)) {
+    const pkgJsonPath = join17(dir, "package.json");
+    if (existsSync6(pkgJsonPath)) {
       try {
         const pkg4 = JSON.parse(readFileSync6(pkgJsonPath, "utf8"));
-        if (pkg4.workspaces || existsSync5(join16(dir, "pnpm-workspace.yaml"))) {
+        if (pkg4.workspaces || existsSync6(join17(dir, "pnpm-workspace.yaml"))) {
           workspaceRootCache.set(startDir, dir);
           return dir;
         }
@@ -14992,8 +15200,8 @@ function getWorkspacePackageDirs(workspaceRoot) {
     return workspacePackageDirsCache.get(workspaceRoot);
   }
   const packageMap = /* @__PURE__ */ new Map();
-  const packagesDir = join16(workspaceRoot, "packages");
-  if (!existsSync5(packagesDir)) {
+  const packagesDir = join17(workspaceRoot, "packages");
+  if (!existsSync6(packagesDir)) {
     workspacePackageDirsCache.set(workspaceRoot, packageMap);
     return packageMap;
   }
@@ -15002,12 +15210,12 @@ function getWorkspacePackageDirs(workspaceRoot) {
       return;
     let entries;
     try {
-      entries = readdirSync2(dir);
+      entries = readdirSync3(dir);
     } catch {
       return;
     }
-    const pkgJsonPath = join16(dir, "package.json");
-    if (existsSync5(pkgJsonPath)) {
+    const pkgJsonPath = join17(dir, "package.json");
+    if (existsSync6(pkgJsonPath)) {
       try {
         const pkg4 = JSON.parse(readFileSync6(pkgJsonPath, "utf8"));
         if (typeof pkg4.name === "string") {
@@ -15019,7 +15227,7 @@ function getWorkspacePackageDirs(workspaceRoot) {
     for (const entry of entries) {
       if (entry === "node_modules" || entry === ".git" || entry.startsWith("."))
         continue;
-      const entryPath = join16(dir, entry);
+      const entryPath = join17(dir, entry);
       try {
         const stat7 = statSync3(entryPath);
         if (stat7.isDirectory()) {
@@ -15059,28 +15267,28 @@ function resolveWorkspaceVueImport(specifier, importingFilePath) {
   const packageDir = packageDirs.get(packageName);
   if (!packageDir)
     return null;
-  const pkgJsonPath = join16(packageDir, "package.json");
+  const pkgJsonPath = join17(packageDir, "package.json");
   try {
     const pkg4 = JSON.parse(readFileSync6(pkgJsonPath, "utf8"));
     if (pkg4.exports && subpath !== ".") {
       const exportValue = pkg4.exports[subpath];
       if (typeof exportValue === "string" && exportValue.endsWith(".vue")) {
         const resolved = resolve14(packageDir, exportValue);
-        if (existsSync5(resolved))
+        if (existsSync6(resolved))
           return resolved;
       }
     }
     if (subpath !== ".") {
       const subDir = resolve14(packageDir, subpath.replace(/^\.\//, ""));
-      for (const base of [join16(packageDir, "src", subpath.replace(/^\.\//, "")), subDir]) {
-        const subPkgPath = join16(base, "package.json");
-        if (existsSync5(subPkgPath)) {
+      for (const base of [join17(packageDir, "src", subpath.replace(/^\.\//, "")), subDir]) {
+        const subPkgPath = join17(base, "package.json");
+        if (existsSync6(subPkgPath)) {
           try {
             const subPkg = JSON.parse(readFileSync6(subPkgPath, "utf8"));
             const main = subPkg.main || subPkg.module;
             if (typeof main === "string" && main.endsWith(".vue")) {
               const resolved = resolve14(base, main);
-              if (existsSync5(resolved))
+              if (existsSync6(resolved))
                 return resolved;
             }
           } catch {
@@ -15092,7 +15300,7 @@ function resolveWorkspaceVueImport(specifier, importingFilePath) {
       const main = pkg4.main || pkg4.module;
       if (typeof main === "string" && main.endsWith(".vue")) {
         const resolved = resolve14(packageDir, main);
-        if (existsSync5(resolved))
+        if (existsSync6(resolved))
           return resolved;
       }
     }
@@ -15534,7 +15742,7 @@ var init_astro = __esm({
 });
 
 // packages/experience-design-system-extraction/dist/src/extract/web-components.js
-import { basename as basename5, dirname as dirname9, join as join17, resolve as resolve15 } from "node:path";
+import { basename as basename5, dirname as dirname9, join as join18, resolve as resolve15 } from "node:path";
 import { Project as Project5, Node as Node8, SyntaxKind as SyntaxKind6 } from "ts-morph";
 function normalizeComponentName(input) {
   return input.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
@@ -16187,14 +16395,14 @@ function resolveImportSourcePath2(fromFilePath, specifier) {
   if (!specifier.startsWith(spectrumPrefix)) {
     return null;
   }
-  const packagesMarker = `${join17("2nd-gen", "packages")}${fromFilePath.includes("\\") ? "\\" : "/"}`;
+  const packagesMarker = `${join18("2nd-gen", "packages")}${fromFilePath.includes("\\") ? "\\" : "/"}`;
   const markerIndex = fromFilePath.lastIndexOf(packagesMarker);
   if (markerIndex === -1) {
     return null;
   }
   const packagesRoot = fromFilePath.slice(0, markerIndex + packagesMarker.length - 1);
   const componentPath = specifier.slice(spectrumPrefix.length);
-  return join17(packagesRoot, "core", "components", componentPath, "index.ts");
+  return join18(packagesRoot, "core", "components", componentPath, "index.ts");
 }
 function getImportedBaseClass(classDecl, project, visitedFiles) {
   const extendsClause = classDecl.getHeritageClauses().find((clause) => clause.getToken() === SyntaxKind6.ExtendsKeyword);
@@ -16461,8 +16669,8 @@ var init_scoring = __esm({
 
 // packages/experience-design-system-extraction/dist/src/extract/svelte.js
 import os3 from "node:os";
-import { basename as basename6, dirname as dirname10, resolve as resolve16, join as join18 } from "node:path";
-import { existsSync as existsSync6, readFileSync as readFileSync7 } from "node:fs";
+import { basename as basename6, dirname as dirname10, resolve as resolve16, join as join19 } from "node:path";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "node:fs";
 import { createRequire } from "node:module";
 import { parse as parseSvelte } from "svelte/compiler";
 import { Project as Project6, Node as Node9, ScriptTarget, ModuleKind, ts as ts2 } from "ts-morph";
@@ -16595,8 +16803,8 @@ async function maybeRunResolveUnreachableRetry(components, warnings, retryContex
 function findNearestTsconfig(startDir) {
   let dir = startDir;
   for (let i = 0; i < 16; i++) {
-    const candidate = join18(dir, "tsconfig.json");
-    if (existsSync6(candidate))
+    const candidate = join19(dir, "tsconfig.json");
+    if (existsSync7(candidate))
       return candidate;
     const parent = dirname10(dir);
     if (!parent || parent === dir)
@@ -16731,29 +16939,29 @@ function locateDtsForSpecifier(req, specifier, parentFile) {
   const seedDir = resolvedJs ? dirname10(resolvedJs) : dirname10(parentFile);
   const pkgRoot = findPackageRootForSpecifier(seedDir, specifier);
   if (pkgRoot) {
-    const pkgJsonPath = join18(pkgRoot, "package.json");
-    if (existsSync6(pkgJsonPath)) {
+    const pkgJsonPath = join19(pkgRoot, "package.json");
+    if (existsSync7(pkgJsonPath)) {
       try {
         const pkgRaw = readFileSync7(pkgJsonPath, "utf-8");
         const pkg4 = JSON.parse(pkgRaw);
         const typesField = pkg4.types ?? pkg4.typings;
         if (typeof typesField === "string") {
           const candidate = resolve16(pkgRoot, typesField);
-          if (existsSync6(candidate))
+          if (existsSync7(candidate))
             return candidate;
         }
         const exportsTypes = extractTypesFromExports(pkg4.exports);
         if (exportsTypes) {
           const candidate = resolve16(pkgRoot, exportsTypes);
-          if (existsSync6(candidate))
+          if (existsSync7(candidate))
             return candidate;
         }
       } catch {
       }
     }
     for (const entry of ["index.d.ts", "index.d.mts"]) {
-      const candidate = join18(pkgRoot, entry);
-      if (existsSync6(candidate))
+      const candidate = join19(pkgRoot, entry);
+      if (existsSync7(candidate))
         return candidate;
     }
   }
@@ -16761,7 +16969,7 @@ function locateDtsForSpecifier(req, specifier, parentFile) {
     const noExt = resolvedJs.replace(/\.(m?js|cjs)$/, "");
     for (const ext of [".d.ts", ".d.mts"]) {
       const candidate = `${noExt}${ext}`;
-      if (existsSync6(candidate))
+      if (existsSync7(candidate))
         return candidate;
     }
   }
@@ -16770,9 +16978,9 @@ function locateDtsForSpecifier(req, specifier, parentFile) {
 function findPackageRootForSpecifier(seedDir, specifier) {
   let dir = seedDir;
   for (let i = 0; i < 32; i++) {
-    if (existsSync6(join18(dir, "package.json"))) {
+    if (existsSync7(join19(dir, "package.json"))) {
       try {
-        const pkgRaw = readFileSync7(join18(dir, "package.json"), "utf-8");
+        const pkgRaw = readFileSync7(join19(dir, "package.json"), "utf-8");
         const pkg4 = JSON.parse(pkgRaw);
         if (pkg4.name === specifier)
           return dir;
@@ -20126,17 +20334,17 @@ function buildCycleUnits(slotCycles) {
   const groups = /* @__PURE__ */ new Map();
   for (const node of parent.keys()) {
     const root = find(node);
-    let group = groups.get(root);
-    if (!group) {
-      group = /* @__PURE__ */ new Set();
-      groups.set(root, group);
+    let group2 = groups.get(root);
+    if (!group2) {
+      group2 = /* @__PURE__ */ new Set();
+      groups.set(root, group2);
     }
-    group.add(node);
+    group2.add(node);
   }
   const out = /* @__PURE__ */ new Map();
-  for (const group of groups.values()) {
-    for (const node of group) {
-      out.set(node, group);
+  for (const group2 of groups.values()) {
+    for (const node of group2) {
+      out.set(node, group2);
     }
   }
   return out;
@@ -21630,10 +21838,10 @@ function swapValues(values, firstIndex, secondIndex) {
   [next[firstIndex], next[secondIndex]] = [next[secondIndex], next[firstIndex]];
   return next;
 }
-function parseToState(json) {
+function parseToState(json2) {
   let parsed;
   try {
-    parsed = JSON.parse(json);
+    parsed = JSON.parse(json2);
   } catch (e) {
     return {
       state: { componentDescription: "", props: [], slots: [] },
@@ -22486,11 +22694,11 @@ function FieldEditor({
     setEditorState(next);
     onChange(serializeState(next, value));
   };
-  const canonicalize = React14.useCallback((json) => {
+  const canonicalize = React14.useCallback((json2) => {
     try {
-      return JSON.stringify(JSON.parse(json));
+      return JSON.stringify(JSON.parse(json2));
     } catch {
-      return `__unparseable__:${json}`;
+      return `__unparseable__:${json2}`;
     }
   }, []);
   const initialStateRef = React14.useRef(initialState);
@@ -23064,14 +23272,14 @@ function FieldEditor({
   })();
   const rows = [];
   rows.push({ kind: "component-description" });
-  for (const group of propGroups.filter((candidate) => candidate.kind !== "hidden")) {
-    if (group.indexes.length === 0) continue;
+  for (const group2 of propGroups.filter((candidate) => candidate.kind !== "hidden")) {
+    if (group2.indexes.length === 0) continue;
     rows.push({
       kind: "header",
-      label: `${group.label} (${group.indexes.length}) `,
-      section: group.kind
+      label: `${group2.label} (${group2.indexes.length}) `,
+      section: group2.kind
     });
-    group.indexes.forEach((idx) => rows.push({ kind: "prop", idx }));
+    group2.indexes.forEach((idx) => rows.push({ kind: "prop", idx }));
   }
   if (slots.length > 0) {
     rows.push({
@@ -23081,7 +23289,7 @@ function FieldEditor({
     });
     slots.forEach((_, i) => rows.push({ kind: "slot", idx: i }));
   }
-  const hiddenGroup = propGroups.find((group) => group.kind === "hidden");
+  const hiddenGroup = propGroups.find((group2) => group2.kind === "hidden");
   if (hiddenGroup && hiddenGroup.indexes.length > 0) {
     rows.push({
       kind: "header",
@@ -26866,7 +27074,7 @@ var init_fetch_existing_contentful_entities = __esm({
 
 // packages/experience-design-system-cli-legacy/src/helpers/fetch-and-persist-existing-contentful-entities.ts
 import { writeFile as writeFile5 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { join as join20 } from "node:path";
 async function fetchAndPersistExistingContentfulEntities(params) {
   const t0 = Date.now();
   try {
@@ -26878,7 +27086,7 @@ async function fetchAndPersistExistingContentfulEntities(params) {
       spaceId: params.spaceId,
       environmentId: params.environmentId
     });
-    const path = join19(params.outDir, ".existing-entities.json");
+    const path = join20(params.outDir, ".existing-entities.json");
     await writeFile5(path, JSON.stringify(entities, null, 2), "utf8");
     return { ok: true, path, durationMs: Date.now() - t0, entities };
   } catch (error) {
@@ -27055,8 +27263,8 @@ __export(WizardApp_exports, {
 });
 import { useEffect as useEffect15, useRef as useRef10, useState as useState23 } from "react";
 import { Box as Box42, Text as Text46 } from "ink";
-import { join as join20, resolve as resolve17 } from "node:path";
-import { appendFileSync as appendFileSync2, writeFileSync } from "node:fs";
+import { join as join21, resolve as resolve17 } from "node:path";
+import { appendFileSync as appendFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { access as access7, stat as stat5, writeFile as writeFile6 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { execFile as execFile2, spawn as spawn3 } from "node:child_process";
@@ -27196,7 +27404,7 @@ function WizardApp({
   const logInit = useRef10(false);
   const initialAgentAuthRef = useRef10(initialAgentAuth ?? null);
   if (!logInit.current) {
-    writeFileSync(WIZARD_LOG, `--- experiences import session ${(/* @__PURE__ */ new Date()).toISOString()} ---
+    writeFileSync2(WIZARD_LOG, `--- experiences import session ${(/* @__PURE__ */ new Date()).toISOString()} ---
 `);
     logInit.current = true;
   }
@@ -27205,6 +27413,7 @@ function WizardApp({
     tokensPath: ""
   });
   const allowEmptyDeleteAllRef = useRef10(false);
+  const pushDebugRef = useRef10(null);
   const generateChildRef = useRef10(null);
   const generationCachePreflightRef = useRef10(null);
   const selectionToReviewStartedAtRef = useRef10(null);
@@ -27223,7 +27432,7 @@ function WizardApp({
   const rawTokensEntryReady = !!initialRawTokensPath;
   const effectiveNoCache = resolveNoCacheForGenerate({ cliNoCache: noCache });
   const initialStepResolved = rawTokensEntryReady ? initialProjectPath ? "path-validation" : "credentials" : initialProjectPath ? "token-input" : "welcome";
-  const initialOutDir = initialProjectPath ? join20(resolve17(initialProjectPath), ".contentful") : "";
+  const initialOutDir = initialProjectPath ? join21(resolve17(initialProjectPath), ".contentful") : "";
   const [state, setState] = useState23({
     step: initialStepResolved,
     agent: initialAgent ?? "claude",
@@ -27421,7 +27630,7 @@ If you are using AWS Bedrock, run:
     }
     const sessionMatch = /^session=(.+)$/m.exec(result.stdout);
     const tokenSessionId = sessionMatch ? sessionMatch[1].trim() : null;
-    const tokensPath = join20(outDir, "tokens.json");
+    const tokensPath = join21(outDir, "tokens.json");
     const printArgs = ["print", "tokens", "--out", tokensPath];
     if (tokenSessionId) printArgs.push("--session", tokenSessionId);
     const r = await runCli(printArgs);
@@ -27443,7 +27652,7 @@ If you are using AWS Bedrock, run:
         tokenGenerationStatus: "complete",
         skipComponents: true,
         acceptedCount: 0,
-        outDir: state.outDir || join20(process.cwd(), ".contentful")
+        outDir: state.outDir || join21(process.cwd(), ".contentful")
       });
       update({ step: "credentials" });
       return true;
@@ -27584,7 +27793,7 @@ If you are using AWS Bedrock, run:
     return promise;
   };
   const runExtract = async (projectPath, showProgress = true) => {
-    const outDir = join20(resolve17(projectPath), ".contentful");
+    const outDir = join21(resolve17(projectPath), ".contentful");
     const existingEntitiesExpected = !state.credentialsSkipped && Boolean(state.spaceId && state.environmentId && state.cmaToken && projectPath);
     update({
       ...showProgress ? { step: "extracting" } : {},
@@ -28259,12 +28468,30 @@ Make sure this path contains TypeScript/React/Vue component files (.tsx, .ts, .v
     void runSaveAndPush();
   };
   const runPreview = async (extractSessionId, tokensPath, spaceId, environmentId, cmaToken, host2) => {
+    const resolvedHost = resolveWizardHost(host2);
+    pushDebugRef.current?.finish({
+      outcome: "superseded",
+      summary: "A new push attempt started before this one finished."
+    });
+    const pushDebug = startPushDebugRun({
+      space_id: spaceId,
+      environment_id: environmentId,
+      host: resolvedHost,
+      cma_token: cmaToken,
+      extract_session_id: extractSessionId,
+      tokens_file: tokensPath || null,
+      delete_everything_not_listed: allowEmptyDeleteAllRef.current
+    });
+    pushDebugRef.current = pushDebug;
     if (shouldBypassPreview(state)) {
+      pushDebug.finish({
+        outcome: "skipped",
+        summary: "Credentials were skipped, so nothing is previewed or pushed. Files were saved only."
+      });
       update(buildSkippedPreviewTransition());
       return;
     }
     update({ step: "previewing" });
-    const resolvedHost = resolveWizardHost(host2);
     try {
       const client2 = new ImportApiClient({
         cmaToken,
@@ -28272,6 +28499,7 @@ Make sure this path contains TypeScript/React/Vue component files (.tsx, .ts, .v
         environmentId,
         host: resolvedHost
       });
+      pushDebug.event("Preview started", { note: `POST ${resolvedHost}/\u2026/design_systems/imports/preview` });
       let components = [];
       if (extractSessionId) {
         const db = openPipelineDb();
@@ -28287,7 +28515,16 @@ Make sure this path contains TypeScript/React/Vue component files (.tsx, .ts, .v
         tokens = await readTokensFromPath("tokens", tokensPath);
       }
       let cdf = buildCDF3(components, toCDFTokens(tokens), { deleteAll: allowEmptyDeleteAllRef.current });
+      pushDebug.event("Built the CDF to send", {
+        note: `${summarizeCdf(cdf).length} entries`,
+        data: { entries: summarizeCdf(cdf), tokens_loaded: tokens.length }
+      });
       let preview = await client2.previewImport(cdf);
+      pushDebug.event("Server previewed the CDF", {
+        note: "what the server would create, change, leave alone or remove",
+        data: summarizePreview(preview),
+        requestId: client2.getLastRequestId()
+      });
       if (extractSessionId) {
         let needsRepreview = false;
         const db = openPipelineDb();
@@ -28307,15 +28544,27 @@ Make sure this path contains TypeScript/React/Vue component files (.tsx, .ts, .v
             if (seededDefaults > 0) needsRepreview = true;
           }
           if (needsRepreview) {
+            pushDebug.event("Re-previewing", {
+              note: "the server listed components as removed or changed that exist locally, so defaults were filled in"
+            });
             components = loadCDFComponents(db, extractSessionId);
             cdf = buildCDF3(components, toCDFTokens(tokens), { deleteAll: allowEmptyDeleteAllRef.current });
             preview = await client2.previewImport(cdf);
+            pushDebug.event("Server previewed the updated CDF", {
+              data: summarizePreview(preview),
+              requestId: client2.getLastRequestId()
+            });
           }
         } finally {
           db.close();
         }
       }
       if (isEmptyPreview(preview)) {
+        pushDebug.finish({
+          outcome: "nothing-to-push",
+          summary: "The server says every component and token in the CDF already matches what is in this space, so no apply request was sent. If the space looks empty, check that this is the space and environment you are viewing.",
+          details: { preview: summarizePreview(preview), request_id: client2.getLastRequestId() }
+        });
         update({
           step: "done",
           serverPreview: preview,
@@ -28327,6 +28576,9 @@ Make sure this path contains TypeScript/React/Vue component files (.tsx, .ts, .v
         });
         return;
       }
+      pushDebug.event("Waiting for confirmation", {
+        note: "the preview shows changes, so the wizard asks before pushing"
+      });
       update({
         step: "preview-gate",
         serverPreview: preview,
@@ -28335,6 +28587,11 @@ Make sure this path contains TypeScript/React/Vue component files (.tsx, .ts, .v
         ...clearedValidationErrorState()
       });
     } catch (e) {
+      pushDebug.finish({
+        outcome: "preview-failed",
+        summary: e instanceof ApiError ? `The preview request was rejected with HTTP ${e.status}.` : `The preview failed before the server answered: ${e instanceof Error ? e.message : String(e)}`,
+        details: e instanceof ApiError ? { status: e.status, body: (e.body ?? "").slice(0, 4e3) } : { error: e instanceof Error ? e.message : String(e) }
+      });
       if (e instanceof ApiError) {
         if (e.status === 401 || e.status === 403) {
           let bodyMsg = "";
@@ -28397,7 +28654,18 @@ If using a custom host configuration, make sure the space exists on that host.`
     }
   };
   const runPush = async (cdf, spaceId, environmentId, cmaToken, host2, acknowledgeBreakingChanges, preview) => {
+    const pushDebug = pushDebugRef.current ?? startPushDebugRun({
+      space_id: spaceId,
+      environment_id: environmentId,
+      host: resolveWizardHost(host2),
+      cma_token: cmaToken
+    });
+    pushDebugRef.current = pushDebug;
     if (shouldRefusePush(state)) {
+      pushDebug.finish({
+        outcome: "skipped",
+        summary: "Credentials were skipped, so the push was refused. Files were saved only."
+      });
       update(buildSkippedPushTransition());
       return;
     }
@@ -28405,6 +28673,11 @@ If using a custom host configuration, make sure the space exists on that host.`
       const hasComponentChanges = preview.components.new.length > 0 || preview.components.changed.length > 0 || preview.components.removed.length > 0;
       const hasTokenChanges = preview.tokens.new.length > 0 || preview.tokens.changed.length > 0 || preview.tokens.removed.length > 0;
       if (!hasComponentChanges && !hasTokenChanges) {
+        pushDebug.finish({
+          outcome: "nothing-to-push",
+          summary: "The preview had no new, changed or removed items, so no apply request was sent.",
+          details: { preview: summarizePreview(preview) }
+        });
         update({
           step: "done",
           pushResult: {
@@ -28417,6 +28690,11 @@ If using a custom host configuration, make sure the space exists on that host.`
     }
     const cycles = detectSlotCycles(extractComponents(cdf));
     if (cycles.length > 0) {
+      pushDebug.finish({
+        outcome: "failed",
+        summary: "The push was blocked locally because components slot each other in a cycle.",
+        details: { cycles: formatSlotCycleReport(cycles) }
+      });
       update({
         step: "error",
         errorStep: "apply",
@@ -28427,6 +28705,11 @@ If using a custom host configuration, make sure the space exists on that host.`
     }
     const unresolvedSlotReferences = validateSlotReferences2(extractComponents(cdf));
     if (unresolvedSlotReferences.length > 0) {
+      pushDebug.finish({
+        outcome: "failed",
+        summary: "The push was blocked locally because a slot refers to a component that is not in the CDF.",
+        details: { unresolved: formatUnresolvedSlotReferences(unresolvedSlotReferences) }
+      });
       update({
         step: "error",
         errorStep: "apply",
@@ -28436,6 +28719,14 @@ If using a custom host configuration, make sure the space exists on that host.`
       return;
     }
     update({ step: "pushing", pushProgress: null, errorAllowBreakingChangeAcknowledgment: false });
+    pushDebug.event("Apply started", {
+      note: `POST ${resolveWizardHost(host2)}/\u2026/design_systems/imports/apply`,
+      data: {
+        acknowledge_breaking_changes: acknowledgeBreakingChanges,
+        sending: summarizeCdf(cdf),
+        expected: preview ? summarizePreview(preview) : null
+      }
+    });
     try {
       const resolvedHost = resolveWizardHost(host2);
       const client2 = new ImportApiClient({
@@ -28445,6 +28736,11 @@ If using a custom host configuration, make sure the space exists on that host.`
         host: resolvedHost
       });
       let operation = await client2.applyImport(cdf, { acknowledgeBreakingChanges });
+      pushDebug.event("Server accepted the apply request", {
+        note: `operation ${operation.sys.id} is ${operation.sys.status}`,
+        data: { operation_id: operation.sys.id, status: operation.sys.status, summary: operation.summary },
+        requestId: client2.getLastRequestId()
+      });
       try {
         logStep({
           applyResponse: {
@@ -28461,9 +28757,15 @@ If using a custom host configuration, make sure the space exists on that host.`
         pushProgress: { kind: "queued", operationId: operation.sys.id }
       });
       let pollCount = 0;
+      let lastPolledStatus = "";
       operation = await client2.pollOperation(operation.sys.id, {
         onProgress: (op) => {
           pollCount++;
+          const polled = `${op.sys.status} ${op.summary ? `${op.summary.total - op.summary.pending}/${op.summary.total}` : ""}`;
+          if (polled !== lastPolledStatus) {
+            lastPolledStatus = polled;
+            pushDebug.event("Operation status changed", { note: polled.trim(), requestId: client2.getLastRequestId() });
+          }
           const s = op.summary;
           if (s) {
             const done = s.total - s.pending;
@@ -28568,6 +28870,29 @@ If using a custom host configuration, make sure the space exists on that host.`
           );
         }
       }
+      const failedItems = items.filter((item) => item.status === "failed");
+      const pushedCount = items.filter((item) => item.status === "succeeded").length;
+      pushDebug.finish({
+        outcome: pushSucceeded ? "pushed" : pushedCount > 0 ? "partial" : "failed",
+        summary: pushSucceeded ? items.length > 0 ? `The server reports ${pushedCount} of ${items.length} items applied.` : `The operation finished as ${operation.sys.status}, but the server returned no per-item results, so the counts come from the preview.` : `The operation finished as ${operation.sys.status}; ${failedItems.length} item(s) failed.`,
+        details: {
+          operation_id: operation.sys.id,
+          operation_status: operation.sys.status,
+          server_summary: operation.summary,
+          items: items.map((item) => ({
+            type: item.entityType,
+            id: item.id,
+            action: item.action,
+            status: item.status,
+            ...item.error ? { error: formatEdsiError(item.error) } : {}
+          })),
+          shown_to_user: {
+            component_types: pushResult.componentTypes,
+            design_tokens: pushResult.designTokens
+          },
+          request_id: client2.getLastRequestId()
+        }
+      });
       update({ step: "done", pushResult });
     } catch (e) {
       let msg;
@@ -28578,6 +28903,14 @@ If using a custom host configuration, make sure the space exists on that host.`
       } else {
         msg = "Push failed";
       }
+      pushDebug.finish({
+        outcome: "failed",
+        summary: e instanceof ApiError ? `The apply request failed with HTTP ${e.status}.` : `The apply request failed before the server answered: ${msg}`,
+        details: {
+          message: msg,
+          ...e instanceof ApiError ? { status: e.status, body: (e.body ?? "").slice(0, 4e3) } : {}
+        }
+      });
       update({
         step: "error",
         errorStep: "apply",
@@ -28589,7 +28922,7 @@ If using a custom host configuration, make sure the space exists on that host.`
   };
   const runPrintFiles = async (extractSessionId, outDir, opts = {}) => {
     update({ step: "printing" });
-    const componentsPath = join20(outDir, "components.json");
+    const componentsPath = join21(outDir, "components.json");
     try {
       const db = openPipelineDb();
       let components = [];
@@ -28692,7 +29025,7 @@ If using a custom host configuration, make sure the space exists on that host.`
       if (tokenReuseChecked.current) return;
       tokenReuseChecked.current = true;
       const tokenNextStep = state.projectPath ? "path-validation" : "credentials";
-      const existingTokensPath = join20(state.outDir, "tokens.json");
+      const existingTokensPath = join21(state.outDir, "tokens.json");
       if (effectiveNoCache) {
         tokenGenerationPromiseRef.current = runAgentAuthCheck(tokenNextStep).then(
           (ok2) => ok2 ? runGenerateTokens(state.rawTokensPath, state.outDir) : false
@@ -28743,7 +29076,7 @@ If using a custom host configuration, make sure the space exists on that host.`
           {
             onContinue: (path) => {
               const projectPath = normalizePath(path);
-              const outDir = join20(projectPath, ".contentful");
+              const outDir = join21(projectPath, ".contentful");
               update({ step: "token-input", projectPath, outDir });
             },
             onQuit: () => process.exit(0)
@@ -29241,6 +29574,7 @@ var init_WizardApp = __esm({
     init_theme();
     init_run_teaser();
     init_debug_logger();
+    init_push_debug_log();
     init_credentials_store();
     init_path_prompt();
     init_save_path_resolver();
@@ -29285,7 +29619,7 @@ var init_WizardApp = __esm({
     init_use_terminal_size();
     init_render_with_goodbye();
     SAVE_CONFIRMATION_DELAY_MS = 1e3;
-    WIZARD_LOG = join20(tmpdir(), "experiences-import-wizard.log");
+    WIZARD_LOG = join21(tmpdir(), "experiences-import-wizard.log");
   }
 });
 
@@ -29465,7 +29799,7 @@ var init_shell = __esm({
 });
 
 // packages/experience-design-system-cli-legacy/src/setup/lib/checks.ts
-import { join as join21 } from "node:path";
+import { join as join22 } from "node:path";
 function checkNodeVersion(nodeVersion = process.versions.node) {
   const major = Number.parseInt(nodeVersion.split(".")[0], 10);
   return {
@@ -29479,7 +29813,7 @@ async function detectNodeVersionManagers(homeDir, deps = {
   binaryExists,
   pathExists: pathExists3
 }) {
-  const nvmScript = join21(homeDir, ".nvm", "nvm.sh");
+  const nvmScript = join22(homeDir, ".nvm", "nvm.sh");
   return {
     nvm: await deps.binaryExists("nvm") || await deps.pathExists(nvmScript),
     fnm: await deps.binaryExists("fnm"),
@@ -29558,7 +29892,7 @@ var init_report = __esm({
 
 // packages/experience-design-system-cli-legacy/src/doctor/checks.ts
 import { homedir as homedir7 } from "node:os";
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 async function reportNode() {
   section("Checking Node.js version");
   const check = checkNodeVersion();
@@ -29609,12 +29943,12 @@ async function reportPnpm(pkgRoot) {
 }
 async function reportDependencies(pkgRoot) {
   section("Checking dependencies (pnpm install)");
-  if (!await pathExists3(join22(pkgRoot, "node_modules"))) {
+  if (!await pathExists3(join23(pkgRoot, "node_modules"))) {
     info("node_modules not found \u2014 running pnpm install...");
   } else {
     info("Running pnpm install to ensure dependencies are up to date...");
   }
-  const check = await installDependencies(join22(pkgRoot, "..", ".."));
+  const check = await installDependencies(join23(pkgRoot, "..", ".."));
   if (!check.passed) {
     fail("pnpm install failed");
     info("");
@@ -29631,7 +29965,7 @@ async function reportDependencies(pkgRoot) {
 async function reportBuild(pkgRoot) {
   section("Building CLI");
   info("Running pnpm build...");
-  const check = await buildCli(join22(pkgRoot, "..", ".."));
+  const check = await buildCli(join23(pkgRoot, "..", ".."));
   if (!check.passed) {
     fail("Build failed");
     info("");
@@ -30846,9 +31180,9 @@ var init_SetupScreen = __esm({
 
 // packages/experience-design-system-cli-legacy/src/setup/command.ts
 import { readFileSync as readFileSync8 } from "node:fs";
-import { join as join23 } from "node:path";
+import { join as join24 } from "node:path";
 function getCliVersion() {
-  const pkg4 = JSON.parse(readFileSync8(join23(findPkgRoot(), "package.json"), "utf8"));
+  const pkg4 = JSON.parse(readFileSync8(join24(findPkgRoot(), "package.json"), "utf8"));
   return pkg4.version;
 }
 async function runSetup(opts) {
@@ -30860,7 +31194,7 @@ async function runSetup(opts) {
   const { renderWithGoodbye: renderWithGoodbye2 } = await Promise.resolve().then(() => (init_render_with_goodbye(), render_with_goodbye_exports));
   const { createElement: createElement6 } = await import("react");
   const { SetupScreen: SetupScreen2 } = await Promise.resolve().then(() => (init_SetupScreen(), SetupScreen_exports));
-  const repoRoot = join23(findPkgRoot(), "..", "..");
+  const repoRoot = join24(findPkgRoot(), "..", "..");
   const completion = { outcome: null };
   let unmountInk = null;
   const { waitUntilExit, unmount } = renderWithGoodbye2(
@@ -31061,15 +31395,15 @@ var init_apply_mapping = __esm({
 });
 
 // packages/experience-design-system-cli-legacy/src/analyze/composition/prompt-loader.ts
-import { existsSync as existsSync7, readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname11, join as join24, resolve as resolve18 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync9 } from "node:fs";
+import { dirname as dirname11, join as join25, resolve as resolve18 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function resolvePromptPath(fileName) {
   const thisDir = dirname11(fileURLToPath3(import.meta.url));
   let dir = thisDir;
   for (; ; ) {
-    const candidate = join24(dir, "prompts");
-    if (existsSync7(candidate)) return join24(candidate, fileName);
+    const candidate = join25(dir, "prompts");
+    if (existsSync8(candidate)) return join25(candidate, fileName);
     const parent = resolve18(dir, "..");
     if (parent === dir) {
       throw new Error(
@@ -31337,7 +31671,7 @@ var init_manifest_doc_evidence = __esm({
 
 // packages/experience-design-system-cli-legacy/src/analyze/extract-command.ts
 import { mkdir as mkdir6, readdir as readdir3, readFile as readFile18, stat as stat6 } from "node:fs/promises";
-import { isAbsolute as isAbsolute2, join as join25, relative as relative2, resolve as resolve19 } from "node:path";
+import { isAbsolute as isAbsolute2, join as join26, relative as relative2, resolve as resolve19 } from "node:path";
 function resolveExtractNoCache(opts) {
   return opts.noCache === true || opts.cache === false;
 }
@@ -31375,7 +31709,7 @@ async function collectSourceFiles(directory, onProgress) {
     const entries = await readdir3(currentDirectory, { withFileTypes: true });
     const subdirs = [];
     for (const entry of entries) {
-      const fullPath = join25(currentDirectory, entry.name);
+      const fullPath = join26(currentDirectory, entry.name);
       if (entry.isDirectory()) {
         if (!IGNORED_DIRECTORY_NAMES.has(entry.name)) {
           subdirs.push(fullPath);
@@ -31459,7 +31793,7 @@ function registerInternalExtractCommand(program) {
       }
     }
     const projectRoot = resolve19(opts.project);
-    const outDir = join25(projectRoot, ".contentful");
+    const outDir = join26(projectRoot, ".contentful");
     let sourceDirectory;
     if (opts.dir !== void 0) {
       sourceDirectory = resolveFromProjectRoot(projectRoot, opts.dir);
@@ -31864,7 +32198,7 @@ __export(program_exports, {
 });
 import { spawn as spawn5 } from "node:child_process";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
-import { dirname as dirname13, join as join26, resolve as resolve20 } from "node:path";
+import { dirname as dirname13, join as join27, resolve as resolve20 } from "node:path";
 import { readFileSync as readFileSync10 } from "node:fs";
 import { Command } from "commander";
 async function runBuild(opts) {
@@ -31964,7 +32298,7 @@ var init_program = __esm({
     init_analytics();
     init_credentials_store();
     init_cli_path();
-    pkg3 = JSON.parse(readFileSync10(join26(findPkgRoot(), "package.json"), "utf8"));
+    pkg3 = JSON.parse(readFileSync10(join27(findPkgRoot(), "package.json"), "utf8"));
   }
 });