@contentful/experience-design-system-cli 2.41.1-dev-build-bf9d918c.0 → 2.41.1-dev-build-c9e39919.0

package/dist/index.js

@@ -18053,10 +18053,10 @@ var init_read_candidate_files = __esm({
 async function selectCompositionPromptFiles(components, sourceFiles) {
   const allFiles = await readCandidateFiles(components, sourceFiles);
   const selectedCandidates = selectCandidateFiles(allFiles).map((c2) => ({ path: c2.path, content: c2.content }));
-  const capped2 = capCandidatesToPromptBudget(selectedCandidates);
-  const promptFiles = capped2.kept;
+  const capped3 = capCandidatesToPromptBudget(selectedCandidates);
+  const promptFiles = capped3.kept;
   const runtimeFiles = allFiles.map((c2) => ({ path: c2.path, content: c2.content }));
-  const droppedWarning = capped2.dropped.length > 0 ? `composition \u2014 ${capped2.dropped.length} candidate file(s) omitted from the agent prompt to fit the context budget; resolution runs on the ${promptFiles.length} highest-value files.` : void 0;
+  const droppedWarning = capped3.dropped.length > 0 ? `composition \u2014 ${capped3.dropped.length} candidate file(s) omitted from the agent prompt to fit the context budget; resolution runs on the ${promptFiles.length} highest-value files.` : void 0;
   return { promptFiles, runtimeFiles, droppedWarning };
 }
 var init_select_composition_prompt_files = __esm({
@@ -29658,7 +29658,13 @@ function useReviewMetadata({ components, selectedIdx, extractSessionId }) {
   }, [components, extractSessionId, selectedIdx]);
   return { reviewMetadata, componentRationale };
 }
-function useReviewHistory({ loading, components, createSnapshot, applySnapshot }) {
+function useReviewHistory({
+  loading,
+  components,
+  createSnapshot,
+  applySnapshot,
+  onAction
+}) {
   const historyRef = useRef13(null);
   const historySeededRef = useRef13(false);
   useEffect19(() => {
@@ -29669,14 +29675,19 @@ function useReviewHistory({ loading, components, createSnapshot, applySnapshot }
   const pushHistorySnapshot = (entries, label) => {
     if (!historyRef.current) return;
     historyRef.current.push(createSnapshot(entries), label);
+    onAction?.(label);
   };
   const handleUndo = () => {
     const snapshot = historyRef.current?.undo();
-    if (snapshot) applySnapshot(snapshot);
+    if (!snapshot) return;
+    applySnapshot(snapshot);
+    onAction?.("undo");
   };
   const handleRedo = () => {
     const snapshot = historyRef.current?.redo();
-    if (snapshot) applySnapshot(snapshot);
+    if (!snapshot) return;
+    applySnapshot(snapshot);
+    onAction?.("redo");
   };
   const resetHistory = (snapshot) => {
     historyRef.current?.reset(snapshot);
@@ -30423,6 +30434,127 @@ var init_use_review_preview = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/import/steps/09-review/review-log.ts
+function reviewInputs(components) {
+  return { components: components.length, by_status: countStatuses(components) };
+}
+function openReviewTrail(components, now) {
+  return {
+    startedAt: now,
+    start: new Map(components.map((component) => [component.key, component.status])),
+    actions: [],
+    kinds: {}
+  };
+}
+function recordReviewAction(trail, label) {
+  const kind = label.split(":")[0] ?? label;
+  trail.kinds[kind] = (trail.kinds[kind] ?? 0) + 1;
+  if (trail.actions.length < MAX_ACTIONS) trail.actions.push(label);
+}
+function render(trail, components, now, outcome) {
+  const acceptedByUser = [];
+  const rejectedByUser = [];
+  for (const { key, status } of components) {
+    const was = trail.start.get(key);
+    if (was === status) continue;
+    if (status === "accepted") acceptedByUser.push(key);
+    if (status === "rejected") rejectedByUser.push(key);
+  }
+  const total = Object.values(trail.kinds).reduce((sum, count) => sum + count, 0);
+  return {
+    outcome,
+    seconds: Math.round((now - trail.startedAt) / 100) / 10,
+    edits: { total, by_kind: trail.kinds, in_order: trail.actions },
+    now: countStatuses(components),
+    accepted_by_user: capped2(acceptedByUser),
+    rejected_by_user: capped2(rejectedByUser)
+  };
+}
+function reviewProgress(trail, components, now) {
+  return render(trail, components, now, "interrupted");
+}
+function reviewFinish(trail, components, now, final) {
+  const outcome = final ? `finalized: ${final.accepted} accepted, ${final.rejected} rejected, ${final.unresolved} unresolved` : "left the review without finishing";
+  return {
+    outputs: render(trail, components, now, outcome),
+    status: "success",
+    exitMethod: final ? "saved" : "discarded"
+  };
+}
+var REVIEW_RUN, MAX_ACTIONS, MAX_NAMES2, countStatuses, capped2;
+var init_review_log = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/09-review/review-log.ts"() {
+    "use strict";
+    REVIEW_RUN = { flow: "import/review", step: "09-review", menuOption: "Review" };
+    MAX_ACTIONS = 30;
+    MAX_NAMES2 = 20;
+    countStatuses = (components) => {
+      const counts = {};
+      for (const { status } of components) counts[status] = (counts[status] ?? 0) + 1;
+      return counts;
+    };
+    capped2 = (keys) => ({
+      count: keys.length,
+      keys: keys.slice(0, MAX_NAMES2)
+    });
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-log.ts
+import { useEffect as useEffect23, useRef as useRef16 } from "react";
+function useReviewLog({
+  loading,
+  loadError,
+  components
+}) {
+  const trail = useRef16(void 0);
+  const started = useRef16(false);
+  const latest = useRef16(components);
+  latest.current = components;
+  useEffect23(() => {
+    if (loading || started.current) return;
+    started.current = true;
+    startDebugRun({ ...REVIEW_RUN, inputs: reviewInputs(components) });
+    if (loadError) {
+      void finishDebugRun({
+        outputs: { outcome: "could not load the components", error: loadError },
+        status: "error",
+        exitMethod: "discarded"
+      });
+      return;
+    }
+    trail.current = openReviewTrail(components, Date.now());
+    setDebugRunProgress(reviewProgress(trail.current, components, Date.now()));
+  }, [loading, loadError, components]);
+  useEffect23(
+    () => () => {
+      const open = trail.current;
+      trail.current = void 0;
+      if (open) void finishDebugRun(reviewFinish(open, latest.current, Date.now(), void 0));
+    },
+    []
+  );
+  return {
+    record: (label) => {
+      if (!trail.current) return;
+      recordReviewAction(trail.current, label);
+      setDebugRunProgress(reviewProgress(trail.current, latest.current, Date.now()));
+    },
+    finish: (counts) => {
+      const open = trail.current;
+      trail.current = void 0;
+      if (open) void finishDebugRun(reviewFinish(open, latest.current, Date.now(), counts));
+    }
+  };
+}
+var init_use_review_log = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/09-review/use-review-log.ts"() {
+    "use strict";
+    init_debug_store();
+    init_review_log();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/components/LivePreviewSummary.tsx
 import { Box as Box37, Text as Text39 } from "ink";
 import { jsx as jsx47, jsxs as jsxs37 } from "react/jsx-runtime";
@@ -30462,7 +30594,7 @@ var init_LivePreviewSummary = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/09-review/generate-review-step.tsx
-import { useCallback as useCallback5, useEffect as useEffect23, useMemo as useMemo6, useRef as useRef16, useState as useState26 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect24, useMemo as useMemo6, useRef as useRef17, useState as useState26 } from "react";
 import figures8 from "figures";
 import { Box as Box38, Text as Text40 } from "ink";
 import { Fragment as Fragment14, jsx as jsx48, jsxs as jsxs38 } from "react/jsx-runtime";
@@ -30659,6 +30791,7 @@ function GenerateReviewStepView({
     tokensPath,
     onExtraLoaded: setLoadedSlotCycles
   });
+  const reviewLog = useReviewLog({ loading, loadError, components });
   const [nav, setNav] = useState26({
     cursorRowIdx: 0,
     sidebarScrollOffset: 0
@@ -30676,7 +30809,7 @@ function GenerateReviewStepView({
     setFinalizeError
   } = reviewSurface;
   const [removedBannerCollapsed, setRemovedBannerCollapsed] = useState26(false);
-  const removedBannerDefaultedRef = useRef16(false);
+  const removedBannerDefaultedRef = useRef17(false);
   const [cyclePanelScroll, setCyclePanelScroll] = useState26(0);
   const [cyclesCursor, setCyclesCursor] = useState26(0);
   const cyclePanel = useOverlayPanel({
@@ -30696,7 +30829,7 @@ function GenerateReviewStepView({
   const [breakCursor, setBreakCursor] = useState26(0);
   const [breakConfirm, setBreakConfirm] = useState26(false);
   const [expandedGroups, setExpandedGroups] = useState26(/* @__PURE__ */ new Set());
-  const seededGroupsRef = useRef16(false);
+  const seededGroupsRef = useRef17(false);
   const {
     searchOpen,
     setSearchOpen,
@@ -30720,7 +30853,7 @@ function GenerateReviewStepView({
   const [pendingEditorFocus, setPendingEditorFocus] = useState26(null);
   const [autoRejected, setAutoRejected] = useState26([]);
   const [undoSnapshot, setUndoSnapshot] = useState26(null);
-  const autoRejectFiredRef = useRef16(false);
+  const autoRejectFiredRef = useRef17(false);
   const [showReloadDialog, setShowReloadDialog] = useState26(false);
   const acceptedCountForPreview = components.filter((c2) => c2.status === "accepted").length;
   const { previewAnnotations, removedComponents, livePreviewHook, livePreviewSpinner } = useReviewPreview({
@@ -30752,7 +30885,10 @@ function GenerateReviewStepView({
     cmaToken,
     host,
     components,
-    onFinalize
+    onFinalize: (accepted, rejected, unresolved) => {
+      reviewLog.finish({ accepted, rejected, unresolved });
+      onFinalize(accepted, rejected, unresolved);
+    }
   });
   const recomputeCycles = (currentComponents) => {
     try {
@@ -30783,7 +30919,7 @@ function GenerateReviewStepView({
     [components]
   );
   const closures = useMemo6(() => computeAllClosures(componentGraph), [componentGraph]);
-  useEffect23(() => {
+  useEffect24(() => {
     if (seededGroupsRef.current) return;
     if (closures.size === 0 && slotCycles.length === 0) return;
     seededGroupsRef.current = true;
@@ -30810,7 +30946,7 @@ function GenerateReviewStepView({
       suggestedBreak: cycle.edges.length > 0 ? suggestCycleBreakEdge2(cycle, cycleView.pushBlocking) : null
     }));
   }, [slotCycles, cycleView]);
-  useEffect23(() => {
+  useEffect24(() => {
     const decision = computeAutoRejectDecision({
       loading,
       autoRejectFired: autoRejectFiredRef.current,
@@ -30851,10 +30987,11 @@ function GenerateReviewStepView({
       autoRejected,
       undoSnapshot
     }),
-    applySnapshot: applyHistorySnapshot
+    applySnapshot: applyHistorySnapshot,
+    onAction: reviewLog.record
   });
-  const autoRejectPushedRef = useRef16(false);
-  useEffect23(() => {
+  const autoRejectPushedRef = useRef17(false);
+  useEffect24(() => {
     if (loading) return;
     if (!historySeededRef.current) return;
     if (!autoRejectFiredRef.current) return;
@@ -30938,7 +31075,7 @@ function GenerateReviewStepView({
   const panelHeight = leftPanelHeight + 2;
   const panelContentHeight = Math.max(1, panelHeight - 3);
   const cycleViewportHeight = Math.max(1, panelHeight - 4);
-  useEffect23(() => {
+  useEffect24(() => {
     if (selectableRowPositions.length === 0) return;
     const cursorInRange = selectableRowPositions.includes(cursorRowIdx);
     const maxScroll = Math.max(0, visibleRowsMemo.length - visibleCount);
@@ -31767,6 +31904,7 @@ var init_generate_review_step = __esm({
     init_ReviewDialogs();
     init_review_input();
     init_use_review_preview();
+    init_use_review_log();
     init_LivePreviewSummary();
     HELP_SECTIONS2 = [
       {
@@ -32020,10 +32158,10 @@ var init_path_utils = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-blinking-cursor.ts
-import { useEffect as useEffect24, useState as useState27 } from "react";
+import { useEffect as useEffect25, useState as useState27 } from "react";
 function useBlinkingCursor() {
   const [visible, setVisible] = useState27(true);
-  useEffect24(() => {
+  useEffect25(() => {
     const interval = setInterval(() => setVisible((current) => !current), 500);
     return () => clearInterval(interval);
   }, []);
@@ -32160,12 +32298,12 @@ var init_produced = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/support/use-timed-spinner.tsx
-import { useEffect as useEffect25, useState as useState29 } from "react";
+import { useEffect as useEffect26, useState as useState29 } from "react";
 import { Spinner as Spinner2 } from "@inkjs/ui";
 import { jsx as jsx53 } from "react/jsx-runtime";
 function useTimedSpinner() {
   const [elapsedSeconds, setElapsedSeconds] = useState29(0);
-  useEffect25(() => {
+  useEffect26(() => {
     const timer = setInterval(() => setElapsedSeconds((current) => current + 1), 1e3);
     return () => {
       clearInterval(timer);
@@ -32434,7 +32572,7 @@ var init_preview_confirmation_input = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/screens/WizardPreviewStep.tsx
-import { useEffect as useEffect26, useState as useState30, useMemo as useMemo7 } from "react";
+import { useEffect as useEffect27, useState as useState30, useMemo as useMemo7 } from "react";
 import { Box as Box44, Text as Text46 } from "ink";
 import { Fragment as Fragment16, jsx as jsx55, jsxs as jsxs44 } from "react/jsx-runtime";
 function buildPreviewSummaryLines(preview) {
@@ -32644,7 +32782,7 @@ function WizardPreviewStep({
   const activeLines = diffExpanded ? diffLines : summaryLines;
   const maxScroll = Math.max(0, activeLines.length - viewportHeight);
   const boundedScrollOffset = Math.min(scrollOffset, maxScroll);
-  useEffect26(() => {
+  useEffect27(() => {
     setScrollOffset((previous) => Math.min(previous, maxScroll));
   }, [maxScroll]);
   useImmediateInput((input, key) => {
@@ -32817,7 +32955,7 @@ function arrive(trail, state2) {
   return next;
 }
 function openTrail(state2, now) {
-  return arrive({ startedAt: now, stageStartedAt: now, at: state2.step, stages: [], edits: 0 }, state2);
+  return arrive({ startedAt: now, stageStartedAt: now, at: state2.step, stages: [] }, state2);
 }
 function advance(trail, from, to, now) {
   const next = { ...trail, stages: [...trail.stages], stageStartedAt: now };
@@ -32831,16 +32969,14 @@ function advance(trail, from, to, now) {
     next.pushFailed = pushHasFailures(to.pushResult);
   }
   if (from.step === "printing" && !failed) next.saved = { path: to.componentsPath, run_id: to.lastRunId };
-  if (from.step === "preview-gate" && to.step === "final-review") next.edits += 1;
   return arrive(next, to);
 }
-function render(trail, now, outcome) {
+function render2(trail, now, outcome) {
   return {
     outcome,
     total_seconds: seconds(now - trail.startedAt),
     stages: trail.stages,
     ...trail.preview ? { preview: trail.preview } : {},
-    ...trail.edits > 0 ? { edited_definitions_after_preview: trail.edits } : {},
     ...trail.push ? { push: trail.push } : {},
     ...trail.saved ? { saved: trail.saved } : {},
     ...trail.failure ? { error: trail.failure } : {},
@@ -32848,13 +32984,20 @@ function render(trail, now, outcome) {
   };
 }
 function flowProgress(trail, now) {
-  return render(trail, now, `interrupted at ${LABELS[trail.at]}`);
+  return render2(trail, now, `interrupted at ${LABELS[trail.at]}`);
 }
 function flowFinish(trail, final, now) {
   if (!final) {
     const midWork = WORK.includes(trail.at);
     const outcome2 = `left the import ${midWork ? "while" : "at"} ${LABELS[trail.at]}${midWork ? " was running" : ""}`;
-    return { outputs: render(trail, now, outcome2), status: midWork ? "error" : "success", exitMethod: "discarded" };
+    return { outputs: render2(trail, now, outcome2), status: midWork ? "error" : "success", exitMethod: "discarded" };
+  }
+  if (final.step === "final-review") {
+    return {
+      outputs: render2(trail, now, "went back to edit the definitions"),
+      status: "success",
+      exitMethod: "discarded"
+    };
   }
   let outcome;
   let failed = true;
@@ -32869,7 +33012,7 @@ function flowFinish(trail, final, now) {
     outcome = final.credentialsSkipped ? "saved without pushing (credentials skipped)" : "published";
   }
   return {
-    outputs: render(trail, now, outcome),
+    outputs: render2(trail, now, outcome),
     status: failed ? "error" : "success",
     exitMethod: failed ? "discarded" : "saved"
   };
@@ -32893,7 +33036,7 @@ var init_flow_log = __esm({
       "preview-validation-error": "Preview validation"
     };
     WORK = ["printing", "previewing", "pushing"];
-    FINISHED = ["done", "error", "preview-validation-error"];
+    FINISHED = ["done", "error", "preview-validation-error", "final-review"];
     MAX_LOGGED = 10;
     MAX_OUTCOME = 200;
     scrub = (text, state2) => scrubError(text, [state2.cmaToken]);
@@ -32904,11 +33047,11 @@ var init_flow_log = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow-log.ts
-import { useEffect as useEffect27, useRef as useRef17 } from "react";
+import { useEffect as useEffect28, useRef as useRef18 } from "react";
 function useFlowLog(state2) {
-  const trail = useRef17(void 0);
-  const previous = useRef17(void 0);
-  useEffect27(() => {
+  const trail = useRef18(void 0);
+  const previous = useRef18(void 0);
+  useEffect28(() => {
     const before = previous.current;
     previous.current = state2;
     const moved = before !== void 0 && before.step !== state2.step;
@@ -32931,7 +33074,7 @@ function useFlowLog(state2) {
     trail.current = open;
     setDebugRunProgress(flowProgress(open, now));
   }, [state2]);
-  useEffect27(
+  useEffect28(
     () => () => {
       const open = trail.current;
       trail.current = void 0;
@@ -33888,9 +34031,9 @@ var init_controller = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-import { useEffect as useEffect28, useRef as useRef18, useSyncExternalStore } from "react";
+import { useEffect as useEffect29, useRef as useRef19, useSyncExternalStore } from "react";
 function useFlow(start, options = {}) {
-  const controller = useRef18();
+  const controller = useRef19();
   if (start && !controller.current) {
     try {
       startWizardLog();
@@ -33907,7 +34050,7 @@ function useFlow(start, options = {}) {
     (listener) => current?.subscribe(listener) ?? (() => void 0),
     () => current?.getState()
   );
-  useEffect28(() => {
+  useEffect29(() => {
     if (!start) controller.current = void 0;
   }, [start]);
   return current && state2 ? { controller: current, state: state2 } : void 0;
@@ -33986,7 +34129,7 @@ var init_help_info = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect29, useState as useState31 } from "react";
+import { useEffect as useEffect30, useState as useState31 } from "react";
 import { Box as Box46, Text as Text47, useInput as useInput13 } from "ink";
 import { Fragment as Fragment17, jsx as jsx57, jsxs as jsxs46 } from "react/jsx-runtime";
 function Section({ title, rows }) {
@@ -34000,7 +34143,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState31();
-  useEffect29(() => {
+  useEffect30(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -34382,7 +34525,7 @@ var init_AgentStatusBadge = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentDetail.tsx
-import { useEffect as useEffect30, useState as useState33 } from "react";
+import { useEffect as useEffect31, useState as useState33 } from "react";
 import { Box as Box48, Text as Text50 } from "ink";
 import { jsx as jsx60, jsxs as jsxs48 } from "react/jsx-runtime";
 function StatusHeading() {
@@ -34403,7 +34546,7 @@ function AgentDetail({
   const [testing, setTesting] = useState33(false);
   const [notice, setNotice] = useState33(null);
   const [checks, setChecks] = useState33(void 0);
-  useEffect30(() => {
+  useEffect31(() => {
     let active = true;
     setChecks(void 0);
     const timer = setTimeout(() => {
@@ -34495,7 +34638,7 @@ var init_AgentDetail = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentsScreen.tsx
-import { useEffect as useEffect31, useRef as useRef19, useState as useState34 } from "react";
+import { useEffect as useEffect32, useRef as useRef20, useState as useState34 } from "react";
 import { Box as Box49, Text as Text51, useInput as useInput15 } from "ink";
 import { Fragment as Fragment18, jsx as jsx61, jsxs as jsxs49 } from "react/jsx-runtime";
 function AgentsScreen({ onDone }) {
@@ -34506,7 +34649,7 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState34(false);
   const [loadError, setLoadError] = useState34(null);
   const [checks, setChecks] = useState34({});
-  const visit = useRef19({
+  const visit = useRef20({
     trail: createTrail(),
     before: void 0,
     environment: void 0,
@@ -34519,7 +34662,7 @@ function AgentsScreen({ onDone }) {
       );
     }
   };
-  useEffect31(() => {
+  useEffect32(() => {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
@@ -34745,7 +34888,7 @@ var init_project_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { useEffect as useEffect32, useRef as useRef20, useState as useState35 } from "react";
+import { useEffect as useEffect33, useRef as useRef21, useState as useState35 } from "react";
 import { Box as Box50, Text as Text52, useInput as useInput16 } from "ink";
 import { Fragment as Fragment19, jsx as jsx62, jsxs as jsxs50 } from "react/jsx-runtime";
 function debugFields(config) {
@@ -34764,14 +34907,14 @@ function ProjectScreen({ onDone }) {
   const [saving, setSaving] = useState35(false);
   const [notice, setNotice] = useState35(null);
   const [loadError, setLoadError] = useState35(null);
-  const visit = useRef20({
+  const visit = useRef21({
     trail: createTrail(),
     before: void 0,
     persisted: void 0,
     error: ""
   }).current;
   const scrub2 = (err) => scrubError(err, [config?.cmaToken ?? ""]);
-  useEffect32(() => {
+  useEffect33(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       visit.before = snapshotOf(cfg);
@@ -34958,13 +35101,13 @@ var init_ConfigurationScreen = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect33, useState as useState37 } from "react";
+import { useEffect as useEffect34, useState as useState37 } from "react";
 import { Box as Box52, Text as Text54, useInput as useInput18 } from "ink";
 import { Fragment as Fragment20, jsx as jsx64, jsxs as jsxs52 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState37(true);
   const [enabled, setEnabled] = useState37(true);
-  useEffect33(() => {
+  useEffect34(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -35027,7 +35170,7 @@ var init_screen12 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect34, useRef as useRef21, useState as useState38 } from "react";
+import { useEffect as useEffect35, useRef as useRef22, useState as useState38 } from "react";
 import { Box as Box53, Text as Text55, useInput as useInput19 } from "ink";
 import { Fragment as Fragment21, jsx as jsx65, jsxs as jsxs53 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
@@ -35037,8 +35180,8 @@ function DebugModeScreen({ onDone }) {
     RETENTION_CHOICES[RETENTION_CHOICES.length - 1]
   );
   const [notice, setNotice] = useState38(null);
-  const visit = useRef21({ trail: createTrail(), before: void 0, error: "" }).current;
-  useEffect34(() => {
+  const visit = useRef22({ trail: createTrail(), before: void 0, error: "" }).current;
+  useEffect35(() => {
     readDebugModeSetting().then((loaded) => {
       setSetting(loaded);
       setPending(loaded.retentionDays);
@@ -35179,7 +35322,7 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { useEffect as useEffect35, useState as useState39 } from "react";
+import { useEffect as useEffect36, useState as useState39 } from "react";
 import { Fragment as Fragment22, jsx as jsx66 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState39("start");
@@ -35213,7 +35356,7 @@ function App({ importOptions, inkClear }) {
   const [flowStart, setFlowStart] = useState39();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState39();
-  useEffect35(() => {
+  useEffect36(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -35286,7 +35429,7 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect35(() => {
+  useEffect36(() => {
     if (!tokensOnlyRun || tokensOnly?.status !== "done" || !tokensOnly.result.ok) return;
     const { credentialsSkipped, input, tokens } = tokensOnlyRun;
     const { tokensPath, tokenSessionId, tokenCount } = tokensOnly.result;
@@ -35308,12 +35451,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   }, [tokensOnly, tokensOnlyRun]);
-  useEffect35(() => {
+  useEffect36(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect35(() => {
+  useEffect36(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -35331,7 +35474,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect35(() => {
+  useEffect36(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -35638,9 +35781,9 @@ var pkg = JSON.parse(
 function createProgram() {
   const program = new Command().name("experiences").description("Contentful Experiences design system import CLI").version(pkg.version, "--version", "Print version number");
   registerImportCommand(program, async (options) => {
-    const { render: render2 } = await import("ink");
+    const { render: render3 } = await import("ink");
     const { runApp: runApp2 } = await Promise.resolve().then(() => (init_app(), app_exports));
-    await runApp2(render2, options);
+    await runApp2(render3, options);
   });
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const chain = [];

package/dist/package.json

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

package/dist/src/tui/import/steps/09-review/review-log.d.ts

@@ -0,0 +1,31 @@
+import type { CdfReviewEntry, ReviewComponentStatus } from './types.js';
+export declare const REVIEW_RUN: {
+    readonly flow: "import/review";
+    readonly step: "09-review";
+    readonly menuOption: "Review";
+};
+export type ReviewTrail = {
+    startedAt: number;
+    /** How each component arrived, by key. */
+    start: Map<string, ReviewComponentStatus>;
+    /** The edits in order, as the history labels them (for example `edit-save` or `token-review:size`). */
+    actions: string[];
+    /** The same edits counted by kind, so a long session still reads at a glance. */
+    kinds: Record<string, number>;
+};
+/** What the review starts with: how many components, and how the AI and the checks left them. */
+export declare function reviewInputs(components: CdfReviewEntry[]): Record<string, unknown>;
+export declare function openReviewTrail(components: CdfReviewEntry[], now: number): ReviewTrail;
+export declare function recordReviewAction(trail: ReviewTrail, label: string): void;
+/** What a crash or Ctrl+C writes if it cuts the review short. */
+export declare function reviewProgress(trail: ReviewTrail, components: CdfReviewEntry[], now: number): Record<string, unknown>;
+/** How the review ended. `final` is the count the user confirmed, or undefined when the review was left without finishing. */
+export declare function reviewFinish(trail: ReviewTrail, components: CdfReviewEntry[], now: number, final: {
+    accepted: number;
+    rejected: number;
+    unresolved: number;
+} | undefined): {
+    outputs: Record<string, unknown>;
+    status: 'success';
+    exitMethod: 'saved' | 'discarded';
+};