@contentful/experience-design-system-cli 2.37.1-dev-build-daf63213.0 → 2.37.1-dev-build-f22bf3b7.0

package/dist/app.js

@@ -32,7 +32,7 @@ var init_package_root = __esm({
   }
 });
 
-// packages/experience-design-system-cli/src/tui/upgrade/version.ts
+// packages/experience-design-system-cli/src/tui/home/version.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 import { join as join2 } from "node:path";
 import semver from "semver";
@@ -65,7 +65,7 @@ async function checkForUpgrade() {
 }
 var PACKAGE_NAME, TAGS_URL;
 var init_version = __esm({
-  "packages/experience-design-system-cli/src/tui/upgrade/version.ts"() {
+  "packages/experience-design-system-cli/src/tui/home/version.ts"() {
     "use strict";
     init_package_root();
     PACKAGE_NAME = "@contentful/experience-design-system-cli";
@@ -2330,7 +2330,7 @@ var init_debug_store = __esm({
 
 // packages/experience-design-system-cli/app.tsx
 import { join as join26 } from "node:path";
-import { useEffect as useEffect28, useState as useState37 } from "react";
+import { useEffect as useEffect27, useState as useState36 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -2431,18 +2431,14 @@ var SUBTITLE = "Let's import your design system into Contentful";
 var MIN_TERMINAL_WIDTH = 164;
 var START_ITEMS = [
   { label: "Import", screen: "import" },
-  { label: "Upgrade Version", screen: "upgrade" },
   { label: "Settings", screen: "settings" },
   { label: "Help", screen: "help" }
 ];
-function upgradeItemDisplay(upgradeCheck) {
+function versionStatus(upgradeCheck) {
   if (upgradeCheck?.status === "update-available") {
-    return { label: `Upgrade Version (v${upgradeCheck.latest} available)`, color: PALETTE.warning };
-  }
-  if (upgradeCheck?.status === "up-to-date") {
-    return { label: "Upgrade Version (up to date)", color: PALETTE.muted };
+    return { text: ` (upgrade available v${upgradeCheck.latest})`, color: PALETTE.success };
   }
-  return { label: "Upgrade Version" };
+  return void 0;
 }
 function HomeScreen({ onNavigate }) {
   const [focusIdx, setFocusIdx] = useState2(0);
@@ -2450,7 +2446,7 @@ function HomeScreen({ onNavigate }) {
   const { exit } = useApp();
   const terminalWidth = useTerminalWidth();
   const tooNarrow = terminalWidth < MIN_TERMINAL_WIDTH;
-  const upgradeDisabled = upgradeCheck?.status === "up-to-date";
+  const status = versionStatus(upgradeCheck);
   useEffect2(() => {
     checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
   }, []);
@@ -2470,7 +2466,6 @@ function HomeScreen({ onNavigate }) {
     }
     if (key.return) {
       const item = START_ITEMS[focusIdx];
-      if (item.screen === "upgrade" && upgradeDisabled) return;
       onNavigate(item.screen);
       return;
     }
@@ -2488,26 +2483,16 @@ function HomeScreen({ onNavigate }) {
       /* @__PURE__ */ jsx2(Text2, { color: PALETTE.muted, children: SUBTITLE }),
       /* @__PURE__ */ jsxs(Text2, { color: PALETTE.muted, children: [
         "v",
-        VERSION
+        VERSION,
+        status && /* @__PURE__ */ jsx2(Text2, { color: status.color, children: status.text })
       ] })
     ] }),
     /* @__PURE__ */ jsx2(Box, { marginTop: 1, justifyContent: "center", children: /* @__PURE__ */ jsx2(Box, { flexDirection: "column", children: START_ITEMS.map((item, i) => {
       const focused = i === focusIdx;
-      const isUpgradeItem = item.screen === "upgrade";
-      const display = isUpgradeItem ? upgradeItemDisplay(upgradeCheck) : { label: item.label };
-      const dimmed = isUpgradeItem && upgradeDisabled;
-      return /* @__PURE__ */ jsxs(
-        Text2,
-        {
-          bold: focused && !dimmed,
-          color: dimmed ? PALETTE.muted : focused ? PALETTE.accent : display.color,
-          children: [
-            focused ? `${FOCUS_MARKER} ` : "  ",
-            display.label
-          ]
-        },
+      return /* @__PURE__ */ jsxs(Text2, { bold: focused, color: focused ? PALETTE.accent : void 0, children: [
+        focused ? `${FOCUS_MARKER} ` : "  ",
         item.label
-      );
+      ] }, item.label);
     }) }) }),
     /* @__PURE__ */ jsx2(Box, { marginTop: 1, justifyContent: "center", children: /* @__PURE__ */ jsx2(
       ControlHints,
@@ -9663,8 +9648,8 @@ function extractAccessorProperties(classDecl, applyRuntimeFieldDenylist = false)
     accessors.set(name, entry);
   }
   for (const [name, { getter, setter }] of accessors) {
-    const hasPropertyDecorator = getter?.getDecorators().some((decorator) => decorator.getName() === "property") || setter?.getDecorators().some((decorator) => decorator.getName() === "property");
-    if (!hasPropertyDecorator && !(getter && setter))
+    const hasPropertyDecorator2 = getter?.getDecorators().some((decorator) => decorator.getName() === "property") || setter?.getDecorators().some((decorator) => decorator.getName() === "property");
+    if (!hasPropertyDecorator2 && !(getter && setter))
       continue;
     const type = getter?.getReturnTypeNode()?.getText() ?? setter?.getParameters()[0]?.getTypeNode()?.getText() ?? "any";
     const accessorNode = getter ?? setter;
@@ -12934,9 +12919,9 @@ function generateUlid(now = Date.now()) {
     tsBytes[i] = n & 255;
     n = Math.floor(n / 256);
   }
-  const ts3 = encodeBase32(tsBytes, 10);
+  const ts6 = encodeBase32(tsBytes, 10);
   const rand = encodeBase32(randomBytes2(10), 16);
-  return (ts3 + rand).toUpperCase();
+  return (ts6 + rand).toUpperCase();
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/persistence/src/runs/repositories/read-runs-file.js
@@ -15350,292 +15335,427 @@ async function runMapTokens(request) {
 import { mkdir as mkdir4 } from "node:fs/promises";
 import { relative as relative2 } from "node:path";
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/quality/non-authorable-filter.js
-var HANDLER_TYPE_PATTERN = /=>|EventHandler|Dispatch<|SetStateAction/;
-var REF_TYPE_PATTERN = /Ref<|RefObject<|MutableRefObject/;
-function isHandlerOrRefProp(prop) {
-  if (HANDLER_TYPE_PATTERN.test(prop.type))
-    return true;
-  if (REF_TYPE_PATTERN.test(prop.type))
-    return true;
-  if (/^on[A-Z]/.test(prop.name) || /^set[A-Z]/.test(prop.name))
-    return true;
-  if (prop.name === "ref" || prop.name === "innerRef")
-    return true;
-  return false;
-}
-function hasNoPropsAndNoSlots(props, slots) {
-  return props.length === 0 && slots.length === 0;
-}
-function isContextProviderWithValueProp(props, usesCreateContext) {
-  return !!usesCreateContext && props.some((p) => p.name === "value");
-}
-function isHardwiredContextProvider(props, usesCreateContext) {
-  return !!usesCreateContext && props.length === 0;
-}
-function isSingleDataPropContextWrapper(props, usesCreateContext) {
-  return !!usesCreateContext && props.length === 1 && !isHandlerOrRefProp(props[0]);
-}
-function hasOnlyEventHandlers(props) {
-  return props.length > 0 && props.every(isHandlerOrRefProp);
-}
-function hasNoAuthoringSurface(component) {
-  const { props, slots, usesCreateContext } = component;
-  if (hasNoPropsAndNoSlots(props, slots))
-    return { skip: true, reason: "component has no props and no slots" };
-  if (isContextProviderWithValueProp(props, usesCreateContext))
-    return {
-      skip: true,
-      reason: "source uses createContext and component exposes a Context.Provider value prop"
-    };
-  if (isHardwiredContextProvider(props, usesCreateContext))
-    return {
-      skip: true,
-      reason: "source uses createContext and component has no props"
-    };
-  if (isSingleDataPropContextWrapper(props, usesCreateContext))
-    return {
-      skip: true,
-      reason: "source uses createContext and component has a single non-handler prop"
-    };
-  if (hasOnlyEventHandlers(props))
-    return { skip: true, reason: "every prop is a handler or ref" };
-  return { skip: false };
-}
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/astro/helpers/collect-astro-props-bindings.js
+import { Node as Node10, Project as Project7 } from "ts-morph";
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/evidence/source-inspection.js
-import { readFile as readFile15 } from "node:fs/promises";
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/tsx-shared.js
+import { Project as Project8 } from "ts-morph";
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/constants/review-reasons.js
-var HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON = "data-fetch-wrapper";
-var POSSIBLE_DATA_FETCH_WRAPPER_REASON = "possible-data-fetch-wrapper";
-var ZERO_SURFACE_RENDERED_UI_REASON = "zero-surface:rendered-ui";
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/tsx-node-utils.js
+import { Node as Node12, SyntaxKind as SyntaxKind7 } from "ts-morph";
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/framework-adapters/shared/parse-imported-names.js
-function parseImportedNames(importClause) {
-  const trimmed = importClause.trim();
-  if (!trimmed)
-    return [];
-  const names = [];
-  const defaultAndNamed = trimmed.split(",").map((part) => part.trim());
-  for (const part of defaultAndNamed) {
-    if (!part)
-      continue;
-    if (part.startsWith("{") && part.endsWith("}")) {
-      for (const named of part.slice(1, -1).split(",").map((item) => item.trim()).filter(Boolean)) {
-        const [local2] = named.split(/\s+as\s+/i);
-        if (local2)
-          names.push(local2.trim());
-      }
-      continue;
-    }
-    const [local] = part.split(/\s+as\s+/i);
-    if (local)
-      names.push(local.trim());
-  }
-  return names;
-}
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/resolve-tsx-workspace-imports.js
+import { Node as Node11 } from "ts-morph";
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/evidence/source-inspection.js
-var INFRA_PROP_NAMES = /* @__PURE__ */ new Set(["id", "locale", "preview", "slug", "topic", "previousComponent", "__typename"]);
-var VISIBLE_UI_TAG_PATTERN = /<(?:[A-Z][A-Za-z0-9_.]*|div|span|section|main|article|header|footer|nav|aside|img|video|p|h[1-6]|ul|ol|li|button|input|textarea|select|form|label|table|tbody|thead|tr|td|th)\b/;
-var GENERATED_IMPORT_PATTERN = /from\s+['"][^'"]*__generated[^'"]*['"]/;
-var GENERATED_QUERY_HOOK_PATTERN = /\buse[A-Z][A-Za-z0-9]*(?:Lazy|Suspense)?Query\s*\(/;
-var GQL_FILENAME_PATTERN = /(?:-gql|-ggl)\.[cm]?[jt]sx?$/i;
-var LOADING_NULL_GUARD_PATTERN = /if\s*\([^)]*(?:isLoading|loading|!data|!\w+Collection|!\w+Item|!\w+)\s*[^)]*\)\s*return\s+null\b/;
-var IMPORT_PATTERN = /import\s+(?:type\s+)?(.+?)\s+from\s+['"]([^'"]+)['"]/g;
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function collectSiblingRendererImports(sourceText) {
-  const names = /* @__PURE__ */ new Set();
-  for (const match2 of sourceText.matchAll(IMPORT_PATTERN)) {
-    const importClause = match2[1]?.trim() ?? "";
-    const importPath = match2[2]?.trim() ?? "";
-    if (!importPath.startsWith("./"))
-      continue;
-    if (importPath.includes("__generated"))
-      continue;
-    if (/-g(?:ql|gl)(?:$|\.)/i.test(importPath))
-      continue;
-    for (const name of parseImportedNames(importClause)) {
-      if (name)
-        names.add(name);
-    }
-  }
-  return [...names];
-}
-function hasSiblingForwardRender(sourceText, siblingImports) {
-  return siblingImports.some((name) => {
-    const renderPattern = new RegExp(`<${escapeRegExp(name)}\\b[\\s\\S]*?(?:/>|</${escapeRegExp(name)}>)`);
-    if (!renderPattern.test(sourceText))
-      return false;
-    const siblingSpreadPattern = new RegExp(`<${escapeRegExp(name)}\\b[^>]*\\{\\.\\.\\.(?!props\\b)[^}]+\\}`);
-    const propsPlusSiblingSpreadPattern = new RegExp(`<${escapeRegExp(name)}\\b[^>]*\\{\\.\\.\\.props\\}[^>]*\\{\\.\\.\\.(?!props\\b)[^}]+\\}`);
-    return siblingSpreadPattern.test(sourceText) || propsPlusSiblingSpreadPattern.test(sourceText);
-  });
-}
-function hasVisibleUiRender(sourceText) {
-  return /return\s*(?:\(|<)/.test(sourceText) && VISIBLE_UI_TAG_PATTERN.test(sourceText);
-}
-function infraPropNames(component) {
-  const props = component.props.map((prop) => prop.name);
-  return props.length > 0 && props.every((prop) => INFRA_PROP_NAMES.has(prop)) ? props : [];
-}
-function scoreToConfidence(score) {
-  if (score <= 0)
-    return 0;
-  if (score <= 2)
-    return 2;
-  if (score <= 4)
-    return 3;
-  if (score <= 6)
-    return 4;
-  return 5;
-}
-function dedupeReasons(reasons) {
-  return [...new Set(reasons)];
-}
-async function inspectComponentSource(component) {
-  let sourceText = "";
-  try {
-    sourceText = await readFile15(component.source, "utf8");
-  } catch {
-    return {
-      wrapperConfidence: 0,
-      reviewReasons: [],
-      keepDespiteZeroSurface: false
-    };
-  }
-  const reviewReasons = [];
-  let wrapperScore = 0;
-  const hasGeneratedQueryHook = GENERATED_IMPORT_PATTERN.test(sourceText) && GENERATED_QUERY_HOOK_PATTERN.test(sourceText);
-  const infraProps = infraPropNames(component);
-  const siblingImports = collectSiblingRendererImports(sourceText);
-  if (GQL_FILENAME_PATTERN.test(component.source)) {
-    reviewReasons.push("data-wrapper:gql-filename");
-    wrapperScore += 1;
-  }
-  if (hasGeneratedQueryHook) {
-    reviewReasons.push("data-wrapper:generated-query-hook");
-    wrapperScore += 3;
-  }
-  if (siblingImports.length > 0 && (hasGeneratedQueryHook || infraProps.length > 0)) {
-    reviewReasons.push("data-wrapper:sibling-renderer-import");
-    wrapperScore += 1;
-  }
-  if (hasSiblingForwardRender(sourceText, siblingImports)) {
-    reviewReasons.push("data-wrapper:fetch-forward-render");
-    wrapperScore += 3;
-  }
-  if (sourceText.includes("useContentfulLiveUpdates(") || sourceText.includes("useContentfulContext(")) {
-    reviewReasons.push("data-wrapper:contentful-runtime");
-    wrapperScore += 1;
-  }
-  if (infraProps.length > 0) {
-    reviewReasons.push("data-wrapper:infra-props");
-    wrapperScore += 2;
-  }
-  if (LOADING_NULL_GUARD_PATTERN.test(sourceText)) {
-    reviewReasons.push("data-wrapper:loading-null-guard");
-    wrapperScore += 1;
-  }
-  const wrapperConfidence = scoreToConfidence(wrapperScore);
-  if (wrapperConfidence >= 4) {
-    reviewReasons.unshift(HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON);
-  } else if (wrapperConfidence === 3) {
-    reviewReasons.unshift(POSSIBLE_DATA_FETCH_WRAPPER_REASON);
-  }
-  const keepDespiteZeroSurface = component.props.length === 0 && component.slots.length === 0 && hasVisibleUiRender(sourceText);
-  if (keepDespiteZeroSurface) {
-    reviewReasons.push(ZERO_SURFACE_RENDERED_UI_REASON);
-  }
-  return {
-    wrapperConfidence,
-    reviewReasons: dedupeReasons(reviewReasons),
-    keepDespiteZeroSurface
-  };
-}
-function describeReviewReason(reason) {
-  switch (reason) {
-    case HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON:
-      return "high-confidence data-fetch wrapper";
-    case POSSIBLE_DATA_FETCH_WRAPPER_REASON:
-      return "possible data-fetch wrapper";
-    case "data-wrapper:gql-filename":
-      return "source file follows a gql wrapper naming pattern";
-    case "data-wrapper:generated-query-hook":
-      return "imports and calls a generated query hook";
-    case "data-wrapper:sibling-renderer-import":
-      return "imports a sibling renderer from the same folder";
-    case "data-wrapper:fetch-forward-render":
-      return "forwards fetched data into a sibling renderer";
-    case "data-wrapper:contentful-runtime":
-      return "uses Contentful runtime hooks";
-    case "data-wrapper:infra-props":
-      return "only exposes infra-fetch props";
-    case "data-wrapper:loading-null-guard":
-      return "returns early while loading or when fetched data is missing";
-    case ZERO_SURFACE_RENDERED_UI_REASON:
-      return "source renders visible/compositional UI despite zero extracted props and slots";
-    default:
-      return reason;
-  }
-}
-function describeReviewReasons(reasons) {
-  return dedupeReasons(reasons.map(describeReviewReason));
-}
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/resolve-tsx-tsconfig-path.js
+import ts3 from "typescript";
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/quality/evaluate-extraction-quality.js
-function wrapperConfidenceToIssueCount(confidence) {
-  if (confidence >= 4)
-    return 2;
-  if (confidence === 3)
-    return 1;
-  return 0;
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/tsx-renderable-exports.js
+import { Node as Node13 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/collect-jsx-component-references.js
+import { Node as Node15, SyntaxKind as SyntaxKind9 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/ast/get-jsx-ast-data.js
+import { Node as Node14 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/ast/collect-structural-jsx-evidence.js
+import { SyntaxKind as SyntaxKind8 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-from-react-source-file.js
+import { SyntaxKind as SyntaxKind14 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-component-from-export.js
+import { Node as Node32 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/collect-prop-dataflow.js
+import { Node as Node17, SyntaxKind as SyntaxKind10 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/resolve-component-function.js
+import { Node as Node16 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-props-from-type.js
+import { Node as Node24 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/dom-attribute-surfaces.js
+import { Node as Node18 } from "ts-morph";
+function createTextControlSurface2(onChangeType, specificProps) {
+  return [
+    { name: "autoComplete", type: "string", required: false },
+    ...specificProps,
+    { name: "disabled", type: "boolean", required: false },
+    { name: "name", type: "string", required: false },
+    { name: "onChange", type: onChangeType, required: false },
+    { name: "placeholder", type: "string", required: false },
+    { name: "readOnly", type: "boolean", required: false },
+    { name: "required", type: "boolean", required: false },
+    {
+      name: "value",
+      type: "string | number | readonly string[]",
+      required: false
+    }
+  ];
 }
-async function evaluateExtractionQuality(components, initialWarnings = []) {
-  const inspectedComponents = await Promise.all(components.map(async (component) => ({
-    component,
-    inspection: await inspectComponentSource(component)
-  })));
-  const scoredComponents = [];
-  const warnings = [...initialWarnings];
-  for (const { component, inspection } of inspectedComponents) {
-    const verdict = hasNoAuthoringSurface(component);
-    const keepDespiteZeroSurface = verdict.skip && verdict.reason === "component has no props and no slots" && inspection.keepDespiteZeroSurface;
-    const retainedForReview = verdict.skip && !keepDespiteZeroSurface;
-    if (retainedForReview) {
-      warnings.push(`${component.name}: requires operator review (${verdict.reason})`);
+var DOM_ATTRIBUTE_PROP_SURFACES2 = {
+  HTMLProps: [],
+  HTMLAttributes: [
+    { name: "className", type: "string", required: false },
+    { name: "hidden", type: "boolean", required: false },
+    { name: "id", type: "string", required: false },
+    {
+      name: "onClick",
+      type: "MouseEventHandler<HTMLElement>",
+      required: false
+    },
+    { name: "style", type: "CSSProperties", required: false },
+    { name: "tabIndex", type: "number", required: false },
+    { name: "title", type: "string", required: false }
+  ],
+  ImgHTMLAttributes: [
+    { name: "alt", type: "string", required: false },
+    { name: "crossOrigin", type: "string", required: false },
+    { name: "height", type: "number | string", required: false },
+    {
+      name: "loading",
+      type: "string",
+      required: false,
+      allowedValues: ["eager", "lazy"]
+    },
+    { name: "sizes", type: "string", required: false },
+    { name: "src", type: "string", required: false },
+    { name: "srcSet", type: "string", required: false },
+    { name: "width", type: "number | string", required: false }
+  ],
+  LiHTMLAttributes: [],
+  AnchorHTMLAttributes: [
+    { name: "download", type: "boolean | string", required: false },
+    { name: "href", type: "string", required: false },
+    { name: "hrefLang", type: "string", required: false },
+    { name: "referrerPolicy", type: "string", required: false },
+    { name: "rel", type: "string", required: false },
+    {
+      name: "target",
+      type: "string",
+      required: false,
+      allowedValues: ["_blank", "_parent", "_self", "_top"]
     }
-    if (keepDespiteZeroSurface) {
-      warnings.push(`${component.name}: retained despite 0 props/slots because the source renders visible or compositional UI`);
+  ],
+  ButtonHTMLAttributes: [
+    { name: "autoFocus", type: "boolean", required: false },
+    { name: "disabled", type: "boolean", required: false },
+    { name: "form", type: "string", required: false },
+    { name: "formAction", type: "string", required: false },
+    { name: "formMethod", type: "string", required: false },
+    { name: "formNoValidate", type: "boolean", required: false },
+    { name: "formTarget", type: "string", required: false },
+    { name: "name", type: "string", required: false },
+    {
+      name: "type",
+      type: "string",
+      required: false,
+      allowedValues: ["button", "reset", "submit"]
+    },
+    {
+      name: "value",
+      type: "string | number | readonly string[]",
+      required: false
     }
-    if (inspection.reviewReasons.length > 0) {
-      const reviewNotes = describeReviewReasons(inspection.reviewReasons).filter((note) => note !== "high-confidence data-fetch wrapper").join("; ");
-      if (reviewNotes)
-        warnings.push(`${component.name}: ${reviewNotes}`);
+  ],
+  InputHTMLAttributes: createTextControlSurface2("ChangeEventHandler<HTMLInputElement>", [
+    { name: "checked", type: "boolean", required: false },
+    { name: "max", type: "number | string", required: false },
+    { name: "maxLength", type: "number", required: false },
+    { name: "min", type: "number | string", required: false },
+    { name: "minLength", type: "number", required: false },
+    { name: "type", type: "string", required: false }
+  ]),
+  FieldsetHTMLAttributes: [
+    { name: "disabled", type: "boolean", required: false },
+    { name: "form", type: "string", required: false },
+    { name: "name", type: "string", required: false }
+  ],
+  LabelHTMLAttributes: [
+    { name: "form", type: "string", required: false },
+    { name: "htmlFor", type: "string", required: false }
+  ],
+  SelectHTMLAttributes: [
+    { name: "autoComplete", type: "string", required: false },
+    { name: "disabled", type: "boolean", required: false },
+    { name: "form", type: "string", required: false },
+    { name: "multiple", type: "boolean", required: false },
+    { name: "name", type: "string", required: false },
+    {
+      name: "onChange",
+      type: "ChangeEventHandler<HTMLSelectElement>",
+      required: false
+    },
+    { name: "required", type: "boolean", required: false },
+    { name: "size", type: "number", required: false },
+    {
+      name: "value",
+      type: "string | number | readonly string[]",
+      required: false
     }
-    const extractorReasons = component.reviewReasons ?? [];
-    const nonAuthorableReason = retainedForReview ? [`non-authorable:${verdict.reason}`] : [];
-    const { confidence, reasons } = computeExtractionScore(component, {
-      additionalIssueCount: wrapperConfidenceToIssueCount(inspection.wrapperConfidence) + extractorReasons.length + nonAuthorableReason.length,
-      additionalReasons: [...extractorReasons, ...inspection.reviewReasons, ...nonAuthorableReason]
-    });
-    scoredComponents.push({
-      ...component,
-      extractionConfidence: confidence,
-      reviewReasons: reasons,
-      needsReview: deriveNeedsReview(confidence) || inspection.wrapperConfidence >= 4 || inspection.keepDespiteZeroSurface || retainedForReview || extractorReasons.includes("props-type-unresolved") || (component.needsReview ?? false)
-    });
+  ],
+  SVGAttributes: [
+    {
+      name: "focusable",
+      type: 'boolean | "auto"',
+      required: false,
+      allowedValues: ["auto"]
+    },
+    { name: "height", type: "number | string", required: false },
+    { name: "viewBox", type: "string", required: false },
+    { name: "width", type: "number | string", required: false }
+  ],
+  SVGProps: [],
+  TextareaHTMLAttributes: createTextControlSurface2("ChangeEventHandler<HTMLTextAreaElement>", [
+    { name: "cols", type: "number", required: false },
+    { name: "rows", type: "number", required: false },
+    { name: "wrap", type: "string", required: false }
+  ]),
+  TdHTMLAttributes: [
+    {
+      name: "align",
+      type: "string",
+      required: false,
+      allowedValues: ["center", "char", "justify", "left", "right"]
+    },
+    { name: "colSpan", type: "number", required: false },
+    { name: "headers", type: "string", required: false },
+    { name: "rowSpan", type: "number", required: false },
+    { name: "scope", type: "string", required: false }
+  ]
+};
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/collect-dom-wrapper-contexts.js
+import { Node as Node19 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-dom-is-pure-wrapper.js
+import { Node as Node20 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-omit-wrapped-custom-props.js
+import { Node as Node21 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-pick-type-patterns.js
+import { Node as Node22 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-react-polymorphic.js
+import { Node as Node23 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/resolve-react-props-type.js
+import { Node as Node25 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-binding-defaults.js
+import { Node as Node28 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/filter-impl-alias-props.js
+import { Node as Node26 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-binding-fallback-props.js
+import { Node as Node27, SyntaxKind as SyntaxKind11 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/collect-react-impl-hints.js
+import { Node as Node30, SyntaxKind as SyntaxKind13 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/infer-primitive-dom-props.js
+import { Node as Node29, SyntaxKind as SyntaxKind12 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-prop-types.js
+import { Node as Node31 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/extractor.js
+import { Project as Project9, Node as Node37 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/detect-stencil-class.js
+import { Node as Node33 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/extract-stencil-props.js
+import { Node as Node35 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/stencil-prop-helpers.js
+import { Node as Node34, SyntaxKind as SyntaxKind15 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/extract-stencil-slots.js
+import { Node as Node36 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/resolve-svelte-unresolved-retry.js
+import { Project as Project12, ScriptTarget as ScriptTarget4, ModuleKind as ModuleKind4, ts as ts5 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/scoring/collect-scoring-inputs.js
+var OPAQUE_TYPES2 = /* @__PURE__ */ new Set(["any", "unknown", "object", "Record<string, unknown>", "Record<string, any>"]);
+var OBVIOUS_PROP_NAMES2 = /* @__PURE__ */ new Set([
+  "className",
+  "style",
+  "id",
+  "children",
+  "disabled",
+  "hidden",
+  "onClick",
+  "onChange",
+  "onSubmit",
+  "onBlur",
+  "onFocus",
+  "href",
+  "src",
+  "alt",
+  "type",
+  "value",
+  "checked",
+  "placeholder",
+  "label",
+  "title",
+  "name",
+  "required",
+  "readOnly",
+  "autoFocus",
+  "tabIndex",
+  "role",
+  "aria-label",
+  "aria-describedby"
+]);
+function isWidePrimitiveUnion2(type) {
+  const parts = type.split("|").map((p) => p.trim());
+  if (parts.length < 3)
+    return false;
+  const basePrimitives = /* @__PURE__ */ new Set(["string", "number", "boolean"]);
+  const nullability = /* @__PURE__ */ new Set(["null", "undefined"]);
+  const baseCount = parts.filter((p) => basePrimitives.has(p)).length;
+  const nullabilityCount = parts.filter((p) => nullability.has(p)).length;
+  return baseCount >= 3 || baseCount >= 2 && nullabilityCount > 0 && baseCount + nullabilityCount >= 3;
+}
+function countExtractionIssues(component, options = {}) {
+  let count = 0;
+  const reasons = [];
+  if (component.props.length === 0 && component.slots.length === 0) {
+    count++;
+    reasons.push("no-props-or-slots");
   }
+  if (component.props.length > 50) {
+    count++;
+    reasons.push(`high-prop-count:${component.props.length}`);
+  }
+  for (const prop of component.props) {
+    if (OPAQUE_TYPES2.has(prop.type.trim())) {
+      count++;
+      reasons.push(`opaque-type:${prop.name}`);
+      break;
+    }
+    if (isWidePrimitiveUnion2(prop.type)) {
+      count++;
+      reasons.push(`wide-union:${prop.name}`);
+      break;
+    }
+    if (!prop.description && !OBVIOUS_PROP_NAMES2.has(prop.name)) {
+      count++;
+      reasons.push("props-missing-description");
+      break;
+    }
+  }
+  count += options.additionalIssueCount ?? 0;
+  if (options.additionalReasons && options.additionalReasons.length > 0) {
+    reasons.push(...options.additionalReasons);
+  }
+  return { count, reasons: [...new Set(reasons)] };
+}
+function mapIssueCountToConfidence(count) {
+  if (count === 0)
+    return 5;
+  if (count === 1)
+    return 4;
+  if (count === 2)
+    return 3;
+  if (count === 3)
+    return 2;
+  return 1;
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/scoring/compute-extraction-score.js
+function computeExtractionScore2(component, options = {}) {
+  const { count, reasons } = countExtractionIssues(component, options);
   return {
-    components: validateExtractedComponents(scoredComponents),
-    warnings
+    confidence: mapIssueCountToConfidence(count),
+    reasons
   };
 }
+function deriveNeedsReview2(confidence) {
+  return confidence <= 2;
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/resolve-svelte-type-checker.js
+import { Project as Project10, ScriptTarget as ScriptTarget2, ModuleKind as ModuleKind2, ts as ts4 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/extract-svelte-declaration-data.js
+import { Node as Node38 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/resolve-svelte-external-type-readers.js
+import { Node as Node40, Project as Project11, ScriptTarget as ScriptTarget3, ModuleKind as ModuleKind3 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/extract-svelte-external-type-members.js
+import { Node as Node39 } from "ts-morph";
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/pre-classify.js
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/extract-from-svelte-file.js
+import { parse as parseSvelte2 } from "svelte/compiler";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/extractor.js
+import { Node as Node44 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/helpers/extract-vue-tsx-props.js
+import { Node as Node42 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/helpers/resolve-ast-object.js
+import { Node as Node41, SyntaxKind as SyntaxKind16 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/helpers/extract-vue-tsx-slots.js
+import { Node as Node43, SyntaxKind as SyntaxKind17 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/extractor.js
+import { parse as parseSFC3 } from "@vue/compiler-sfc";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-setup-props.js
+import { Project as Project14, Node as Node47 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-setup-object-props.js
+import { Project as Project13, Node as Node46 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-object-props.js
+import { Node as Node45 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-options-props.js
+import { parse as parseSFC2 } from "@vue/compiler-sfc";
+import { Node as Node48, Project as Project15 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/extractor.js
+import { Project as Project16 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/extract-wc-observed-attrs.js
+import { Node as Node49 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/extract-wc-class-properties.js
+import { Node as Node50 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-decorator-tag.js
+import { Node as Node51 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-sibling-definition.js
+import { Node as Node54, SyntaxKind as SyntaxKind19 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import.js
+import { Node as Node53, SyntaxKind as SyntaxKind18 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import-source.js
+import { Node as Node52 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/extract-wc-template-content.js
+import { Node as Node56 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/collect-wc-html-templates.js
+import { Node as Node55 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-base-class.js
+import { Node as Node57, SyntaxKind as SyntaxKind20 } from "ts-morph";
+
+// packages/experience-design-system-extraction/dist/src/extract/services/classification/helpers/check-prop-types.js
 function isStringLiteralUnion(type) {
   return type.includes("|") && type.includes("'");
 }
@@ -15657,6 +15777,8 @@ function isNumberType(type) {
 function isComplexType(type) {
   return !isSimpleType(type);
 }
+
+// packages/experience-design-system-extraction/dist/src/extract/services/classification/helpers/detect-dom-props.js
 var DOM_PASS_THROUGH_PROPS = /* @__PURE__ */ new Set([
   // Bare HTML / framework styling pass-through
   "className",
@@ -15718,100 +15840,454 @@ function isDomPassThroughProp(name) {
     return true;
   return name.startsWith("data-");
 }
-function preClassifyProp(prop) {
-  const { name, type } = prop;
-  if (/^on[A-Z]/.test(name) || type.includes("=> void") || type.includes("EventHandler")) {
-    return { category: "exclude" };
+
+// packages/experience-design-system-extraction/dist/src/extract/services/classification/classify-component-props.js
+function preClassifyProp(prop) {
+  const { name, type } = prop;
+  if (/^on[A-Z]/.test(name) || type.includes("=> void") || type.includes("EventHandler")) {
+    return { category: "exclude" };
+  }
+  if (name === "ref" || name === "innerRef" || type.includes("Ref<") || type.includes("RefObject<")) {
+    return { category: "exclude" };
+  }
+  if (name === "testId" || name === "data-testid" || name === "dataTestId") {
+    return { category: "exclude" };
+  }
+  if (name === "key") {
+    return { category: "exclude" };
+  }
+  if (type.includes("Dispatch<") || type.includes("SetStateAction")) {
+    return { category: "exclude" };
+  }
+  if (isDomPassThroughProp(name)) {
+    return { category: "exclude" };
+  }
+  if (name === "name" && prop.domAttribute) {
+    return { category: "exclude" };
+  }
+  if (isStringLiteralUnion(type)) {
+    return { category: "design", cdfTypeHint: "enum" };
+  }
+  if (!isComplexType(type)) {
+    const designNameStart = /^(variant|size|spacing|gap|color|bg|theme|align|layout|orientation|position)/i;
+    const designNameEnd = /(Color|Size|Variant|Style)$/;
+    if (designNameStart.test(name) || designNameEnd.test(name)) {
+      return { category: "design", cdfTypeHint: "string" };
+    }
+  }
+  if (isBooleanType(type)) {
+    const stateNames = ["disabled", "loading", "expanded", "isOpen", "selected", "checked", "active", "preview"];
+    if (stateNames.includes(name)) {
+      return { category: "state", cdfTypeHint: "boolean" };
+    }
+  }
+  if (isBooleanType(type)) {
+    const visualToggle = /^(hide|show|enable|disable|vertical|horizontal|reverse|bold|italic|imageOn|with)/i;
+    if (visualToggle.test(name)) {
+      return { category: "design", cdfTypeHint: "boolean" };
+    }
+  }
+  if (name === "componentId" || name === "sectionKey" || name === "locale" || name === "variantIndex") {
+    return { category: "state", cdfTypeHint: "string" };
+  }
+  if (isStringType(type)) {
+    const urlNameStart = /^(href|url|link|src)/i;
+    const urlNameEnd = /(Url|Href|Link|Src)$/;
+    if (urlNameStart.test(name) || urlNameEnd.test(name)) {
+      return { category: "content", cdfTypeHint: "string" };
+    }
+  }
+  if (isStringType(type)) {
+    const textNameStart = /^(label|title|text|description|caption|heading|subheading|body|alt|name|placeholder|summary)/i;
+    const textNameEnd = /(Text|Label|Title|Name)$/;
+    if (textNameStart.test(name) || textNameEnd.test(name)) {
+      return { category: "content", cdfTypeHint: "string" };
+    }
+  }
+  if (isStringType(type)) {
+    return { category: "content", cdfTypeHint: "string" };
+  }
+  if (isBooleanType(type)) {
+    return { category: "design", cdfTypeHint: "boolean" };
+  }
+  if (isNumberType(type)) {
+    return { category: "design", cdfTypeHint: "string" };
+  }
+  return void 0;
+}
+function preClassifyComponent(component) {
+  const props = component.props.flatMap((prop) => {
+    const result = preClassifyProp(prop);
+    if (result?.category === "exclude") {
+      return [];
+    }
+    const { domAttribute: _domAttribute, ...authorableProp } = prop;
+    if (prop.category) {
+      return [authorableProp];
+    }
+    if (!result) {
+      return [authorableProp];
+    }
+    return [
+      {
+        ...authorableProp,
+        category: result.category
+      }
+    ];
+  });
+  return { ...component, props };
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/authorability/evaluate-authorability.js
+var HANDLER_TYPE_PATTERN = /=>|EventHandler|Dispatch<|SetStateAction/;
+var REF_TYPE_PATTERN = /Ref<|RefObject<|MutableRefObject/;
+function isHandlerOrRefProp(prop) {
+  if (HANDLER_TYPE_PATTERN.test(prop.type))
+    return true;
+  if (REF_TYPE_PATTERN.test(prop.type))
+    return true;
+  if (/^on[A-Z]/.test(prop.name) || /^set[A-Z]/.test(prop.name))
+    return true;
+  if (prop.name === "ref" || prop.name === "innerRef")
+    return true;
+  return false;
+}
+function hasNoPropsAndNoSlots(props, slots) {
+  return props.length === 0 && slots.length === 0;
+}
+function isContextProviderWithValueProp(props, usesCreateContext) {
+  return !!usesCreateContext && props.some((p) => p.name === "value");
+}
+function isHardwiredContextProvider(props, usesCreateContext) {
+  return !!usesCreateContext && props.length === 0;
+}
+function isSingleDataPropContextWrapper(props, usesCreateContext) {
+  return !!usesCreateContext && props.length === 1 && !isHandlerOrRefProp(props[0]);
+}
+function hasOnlyEventHandlers(props) {
+  return props.length > 0 && props.every(isHandlerOrRefProp);
+}
+function hasNoAuthoringSurface(component) {
+  const { props, slots, usesCreateContext } = component;
+  if (hasNoPropsAndNoSlots(props, slots))
+    return { skip: true, reason: "component has no props and no slots" };
+  if (isContextProviderWithValueProp(props, usesCreateContext))
+    return {
+      skip: true,
+      reason: "source uses createContext and component exposes a Context.Provider value prop"
+    };
+  if (isHardwiredContextProvider(props, usesCreateContext))
+    return {
+      skip: true,
+      reason: "source uses createContext and component has no props"
+    };
+  if (isSingleDataPropContextWrapper(props, usesCreateContext))
+    return {
+      skip: true,
+      reason: "source uses createContext and component has a single non-handler prop"
+    };
+  if (hasOnlyEventHandlers(props))
+    return { skip: true, reason: "every prop is a handler or ref" };
+  return { skip: false };
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/inspect-component-source.js
+import { readFile as readFile15 } from "node:fs/promises";
+
+// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/parse-source-imports.js
+function parseImportedNames(importClause) {
+  const trimmed = importClause.trim();
+  if (!trimmed)
+    return [];
+  const names = [];
+  const defaultAndNamed = trimmed.split(",").map((part) => part.trim());
+  for (const part of defaultAndNamed) {
+    if (!part)
+      continue;
+    if (part.startsWith("{") && part.endsWith("}")) {
+      for (const named of part.slice(1, -1).split(",").map((item) => item.trim()).filter(Boolean)) {
+        const [local2] = named.split(/\s+as\s+/i);
+        if (local2)
+          names.push(local2.trim());
+      }
+      continue;
+    }
+    const [local] = part.split(/\s+as\s+/i);
+    if (local)
+      names.push(local.trim());
+  }
+  return names;
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/detect-data-wrapper-patterns.js
+var INFRA_PROP_NAMES = /* @__PURE__ */ new Set(["id", "locale", "preview", "slug", "topic", "previousComponent", "__typename"]);
+var VISIBLE_UI_TAG_PATTERN = /<(?:[A-Z][A-Za-z0-9_.]*|div|span|section|main|article|header|footer|nav|aside|img|video|p|h[1-6]|ul|ol|li|button|input|textarea|select|form|label|table|tbody|thead|tr|td|th)\b/;
+var GENERATED_IMPORT_PATTERN = /from\s+['"][^'"]*__generated[^'"]*['"]/;
+var GENERATED_QUERY_HOOK_PATTERN = /\buse[A-Z][A-Za-z0-9]*(?:Lazy|Suspense)?Query\s*\(/;
+var GQL_FILENAME_PATTERN = /(?:-gql|-ggl)\.[cm]?[jt]sx?$/i;
+var LOADING_NULL_GUARD_PATTERN = /if\s*\([^)]*(?:isLoading|loading|!data|!\w+Collection|!\w+Item|!\w+)\s*[^)]*\)\s*return\s+null\b/;
+var IMPORT_PATTERN = /import\s+(?:type\s+)?(.+?)\s+from\s+['"]([^'"]+)['"]/g;
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function collectSiblingRendererImports(sourceText) {
+  const names = /* @__PURE__ */ new Set();
+  for (const match2 of sourceText.matchAll(IMPORT_PATTERN)) {
+    const importClause = match2[1]?.trim() ?? "";
+    const importPath = match2[2]?.trim() ?? "";
+    if (!importPath.startsWith("./"))
+      continue;
+    if (importPath.includes("__generated"))
+      continue;
+    if (/-g(?:ql|gl)(?:$|\.)/i.test(importPath))
+      continue;
+    for (const name of parseImportedNames(importClause)) {
+      if (name)
+        names.add(name);
+    }
   }
-  if (name === "ref" || name === "innerRef" || type.includes("Ref<") || type.includes("RefObject<")) {
-    return { category: "exclude" };
+  return [...names];
+}
+function hasSiblingForwardRender(sourceText, siblingImports) {
+  return siblingImports.some((name) => {
+    const renderPattern = new RegExp(`<${escapeRegExp(name)}\\b[\\s\\S]*?(?:/>|</${escapeRegExp(name)}>)`);
+    if (!renderPattern.test(sourceText))
+      return false;
+    const siblingSpreadPattern = new RegExp(`<${escapeRegExp(name)}\\b[^>]*\\{\\.\\.\\.(?!props\\b)[^}]+\\}`);
+    const propsPlusSiblingSpreadPattern = new RegExp(`<${escapeRegExp(name)}\\b[^>]*\\{\\.\\.\\.props\\}[^>]*\\{\\.\\.\\.(?!props\\b)[^}]+\\}`);
+    return siblingSpreadPattern.test(sourceText) || propsPlusSiblingSpreadPattern.test(sourceText);
+  });
+}
+function hasVisibleUiRender(sourceText) {
+  return /return\s*(?:\(|<)/.test(sourceText) && VISIBLE_UI_TAG_PATTERN.test(sourceText);
+}
+function collectInfraPropNames(component) {
+  const props = component.props.map((prop) => prop.name);
+  return props.length > 0 && props.every((prop) => INFRA_PROP_NAMES.has(prop)) ? props : [];
+}
+function mapScoreToWrapperConfidence(score) {
+  if (score <= 0)
+    return 0;
+  if (score <= 2)
+    return 2;
+  if (score <= 4)
+    return 3;
+  if (score <= 6)
+    return 4;
+  return 5;
+}
+function dedupeStrings(values) {
+  return [...new Set(values)];
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/inspect-component-source.js
+var HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON = "data-fetch-wrapper";
+var POSSIBLE_DATA_FETCH_WRAPPER_REASON = "possible-data-fetch-wrapper";
+var ZERO_SURFACE_RENDERED_UI_REASON = "zero-surface:rendered-ui";
+async function inspectComponentSource(component) {
+  let sourceText = "";
+  try {
+    sourceText = await readFile15(component.source, "utf8");
+  } catch {
+    return {
+      wrapperConfidence: 0,
+      reviewReasons: [],
+      keepDespiteZeroSurface: false
+    };
   }
-  if (name === "testId" || name === "data-testid" || name === "dataTestId") {
-    return { category: "exclude" };
+  const reviewReasons = [];
+  let wrapperScore = 0;
+  const hasGeneratedQueryHook = GENERATED_IMPORT_PATTERN.test(sourceText) && GENERATED_QUERY_HOOK_PATTERN.test(sourceText);
+  const infraProps = collectInfraPropNames(component);
+  const siblingImports = collectSiblingRendererImports(sourceText);
+  if (GQL_FILENAME_PATTERN.test(component.source)) {
+    reviewReasons.push("data-wrapper:gql-filename");
+    wrapperScore += 1;
   }
-  if (name === "key") {
-    return { category: "exclude" };
+  if (hasGeneratedQueryHook) {
+    reviewReasons.push("data-wrapper:generated-query-hook");
+    wrapperScore += 3;
   }
-  if (type.includes("Dispatch<") || type.includes("SetStateAction")) {
-    return { category: "exclude" };
+  if (siblingImports.length > 0 && (hasGeneratedQueryHook || infraProps.length > 0)) {
+    reviewReasons.push("data-wrapper:sibling-renderer-import");
+    wrapperScore += 1;
   }
-  if (isDomPassThroughProp(name)) {
-    return { category: "exclude" };
+  if (hasSiblingForwardRender(sourceText, siblingImports)) {
+    reviewReasons.push("data-wrapper:fetch-forward-render");
+    wrapperScore += 3;
   }
-  if (name === "name" && prop.domAttribute) {
-    return { category: "exclude" };
+  if (sourceText.includes("useContentfulLiveUpdates(") || sourceText.includes("useContentfulContext(")) {
+    reviewReasons.push("data-wrapper:contentful-runtime");
+    wrapperScore += 1;
   }
-  if (isStringLiteralUnion(type)) {
-    return { category: "design", cdfTypeHint: "enum" };
+  if (infraProps.length > 0) {
+    reviewReasons.push("data-wrapper:infra-props");
+    wrapperScore += 2;
   }
-  if (!isComplexType(type)) {
-    const designNameStart = /^(variant|size|spacing|gap|color|bg|theme|align|layout|orientation|position)/i;
-    const designNameEnd = /(Color|Size|Variant|Style)$/;
-    if (designNameStart.test(name) || designNameEnd.test(name)) {
-      return { category: "design", cdfTypeHint: "string" };
-    }
+  if (LOADING_NULL_GUARD_PATTERN.test(sourceText)) {
+    reviewReasons.push("data-wrapper:loading-null-guard");
+    wrapperScore += 1;
   }
-  if (isBooleanType(type)) {
-    const stateNames = ["disabled", "loading", "expanded", "isOpen", "selected", "checked", "active", "preview"];
-    if (stateNames.includes(name)) {
-      return { category: "state", cdfTypeHint: "boolean" };
-    }
+  const wrapperConfidence = mapScoreToWrapperConfidence(wrapperScore);
+  if (wrapperConfidence >= 4) {
+    reviewReasons.unshift(HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON);
+  } else if (wrapperConfidence === 3) {
+    reviewReasons.unshift(POSSIBLE_DATA_FETCH_WRAPPER_REASON);
   }
-  if (isBooleanType(type)) {
-    const visualToggle = /^(hide|show|enable|disable|vertical|horizontal|reverse|bold|italic|imageOn|with)/i;
-    if (visualToggle.test(name)) {
-      return { category: "design", cdfTypeHint: "boolean" };
-    }
+  const keepDespiteZeroSurface = component.props.length === 0 && component.slots.length === 0 && hasVisibleUiRender(sourceText);
+  if (keepDespiteZeroSurface) {
+    reviewReasons.push(ZERO_SURFACE_RENDERED_UI_REASON);
   }
-  if (name === "componentId" || name === "sectionKey" || name === "locale" || name === "variantIndex") {
-    return { category: "state", cdfTypeHint: "string" };
+  return {
+    wrapperConfidence,
+    reviewReasons: dedupeStrings(reviewReasons),
+    keepDespiteZeroSurface
+  };
+}
+function describeReviewReason(reason) {
+  switch (reason) {
+    case HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON:
+      return "high-confidence data-fetch wrapper";
+    case POSSIBLE_DATA_FETCH_WRAPPER_REASON:
+      return "possible data-fetch wrapper";
+    case "data-wrapper:gql-filename":
+      return "source file follows a gql wrapper naming pattern";
+    case "data-wrapper:generated-query-hook":
+      return "imports and calls a generated query hook";
+    case "data-wrapper:sibling-renderer-import":
+      return "imports a sibling renderer from the same folder";
+    case "data-wrapper:fetch-forward-render":
+      return "forwards fetched data into a sibling renderer";
+    case "data-wrapper:contentful-runtime":
+      return "uses Contentful runtime hooks";
+    case "data-wrapper:infra-props":
+      return "only exposes infra-fetch props";
+    case "data-wrapper:loading-null-guard":
+      return "returns early while loading or when fetched data is missing";
+    case ZERO_SURFACE_RENDERED_UI_REASON:
+      return "source renders visible/compositional UI despite zero extracted props and slots";
+    default:
+      return reason;
   }
-  if (isStringType(type)) {
-    const urlNameStart = /^(href|url|link|src)/i;
-    const urlNameEnd = /(Url|Href|Link|Src)$/;
-    if (urlNameStart.test(name) || urlNameEnd.test(name)) {
-      return { category: "content", cdfTypeHint: "string" };
-    }
+}
+function describeReviewReasons(reasons) {
+  return dedupeStrings(reasons.map(describeReviewReason));
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/validate-extracted-components.js
+function validateExtractedComponents2(components) {
+  const nameCounts = /* @__PURE__ */ new Map();
+  for (const component of components) {
+    const key = component.name.trim();
+    nameCounts.set(key, (nameCounts.get(key) ?? 0) + 1);
   }
-  if (isStringType(type)) {
-    const textNameStart = /^(label|title|text|description|caption|heading|subheading|body|alt|name|placeholder|summary)/i;
-    const textNameEnd = /(Text|Label|Title|Name)$/;
-    if (textNameStart.test(name) || textNameEnd.test(name)) {
-      return { category: "content", cdfTypeHint: "string" };
+  return components.map((component) => {
+    const issues = [];
+    if (!component.name.trim()) {
+      issues.push({
+        severity: "error",
+        code: "EMPTY_COMPONENT_NAME",
+        message: "Component name must not be empty"
+      });
     }
-  }
-  if (isStringType(type)) {
-    return { category: "content", cdfTypeHint: "string" };
-  }
-  if (isBooleanType(type)) {
-    return { category: "design", cdfTypeHint: "boolean" };
-  }
-  if (isNumberType(type)) {
-    return { category: "design", cdfTypeHint: "string" };
-  }
-  return void 0;
+    for (let i = 0; i < component.props.length; i++) {
+      if (!component.props[i].name.trim()) {
+        issues.push({
+          severity: "error",
+          code: "EMPTY_PROP_NAME",
+          message: `Prop at index ${i} has an empty name`,
+          field: `props[${i}].name`
+        });
+      }
+    }
+    for (let i = 0; i < component.slots.length; i++) {
+      if (!component.slots[i].name.trim()) {
+        issues.push({
+          severity: "warning",
+          code: "EMPTY_SLOT_NAME",
+          message: `Slot at index ${i} has an empty name`,
+          field: `slots[${i}].name`
+        });
+      }
+    }
+    const propNames = new Set(component.props.map((p) => p.name.trim()).filter(Boolean));
+    for (let i = 0; i < component.slots.length; i++) {
+      const slotName = component.slots[i].name.trim();
+      if (slotName && propNames.has(slotName)) {
+        issues.push({
+          severity: "error",
+          code: "PROP_SLOT_NAME_COLLISION",
+          message: `"${slotName}" is used as both a prop name and a slot name`,
+          field: `slots[${i}].name`
+        });
+      }
+    }
+    const nameKey = component.name.trim();
+    if (nameKey && (nameCounts.get(nameKey) ?? 0) > 1) {
+      issues.push({
+        severity: "error",
+        code: "DUPLICATE_COMPONENT_NAME",
+        message: `Component name "${component.name}" appears more than once in the extracted set`
+      });
+    }
+    if (component.props.length === 0 && component.slots.length === 0) {
+      issues.push({
+        severity: "warning",
+        code: "EMPTY_COMPONENT",
+        message: "Component has no props or slots and will be filtered out during generation"
+      });
+    }
+    return { ...component, validationIssues: issues };
+  });
+}
+
+// packages/experience-design-system-extraction/dist/src/extract/services/quality/evaluate-extraction-quality.js
+function wrapperConfidenceToIssueCount(confidence) {
+  if (confidence >= 4)
+    return 2;
+  if (confidence === 3)
+    return 1;
+  return 0;
 }
-function preClassifyComponent(component) {
-  const props = component.props.flatMap((prop) => {
-    const result = preClassifyProp(prop);
-    if (result?.category === "exclude") {
-      return [];
+async function evaluateExtractionQuality(components, initialWarnings = []) {
+  const inspectedComponents = await Promise.all(components.map(async (component) => ({
+    component,
+    inspection: await inspectComponentSource(component)
+  })));
+  const scoredComponents = [];
+  const warnings = [...initialWarnings];
+  for (const { component, inspection } of inspectedComponents) {
+    const verdict = hasNoAuthoringSurface(component);
+    const keepDespiteZeroSurface = verdict.skip && verdict.reason === "component has no props and no slots" && inspection.keepDespiteZeroSurface;
+    const retainedForReview = verdict.skip && !keepDespiteZeroSurface;
+    if (retainedForReview) {
+      warnings.push(`${component.name}: requires operator review (${verdict.reason})`);
     }
-    const { domAttribute: _domAttribute, ...authorableProp } = prop;
-    if (prop.category) {
-      return [authorableProp];
+    if (keepDespiteZeroSurface) {
+      warnings.push(`${component.name}: retained despite 0 props/slots because the source renders visible or compositional UI`);
     }
-    if (!result) {
-      return [authorableProp];
+    if (inspection.reviewReasons.length > 0) {
+      const reviewNotes = describeReviewReasons(inspection.reviewReasons).filter((note) => note !== "high-confidence data-fetch wrapper").join("; ");
+      if (reviewNotes)
+        warnings.push(`${component.name}: ${reviewNotes}`);
     }
-    return [
-      {
-        ...authorableProp,
-        category: result.category
-      }
-    ];
-  });
-  return { ...component, props };
+    const extractorReasons = component.reviewReasons ?? [];
+    const nonAuthorableReason = retainedForReview ? [`non-authorable:${verdict.reason}`] : [];
+    const { confidence, reasons } = computeExtractionScore2(component, {
+      additionalIssueCount: wrapperConfidenceToIssueCount(inspection.wrapperConfidence) + extractorReasons.length + nonAuthorableReason.length,
+      additionalReasons: [...extractorReasons, ...inspection.reviewReasons, ...nonAuthorableReason]
+    });
+    scoredComponents.push({
+      ...component,
+      extractionConfidence: confidence,
+      reviewReasons: reasons,
+      needsReview: deriveNeedsReview2(confidence) || inspection.wrapperConfidence >= 4 || inspection.keepDespiteZeroSurface || retainedForReview || extractorReasons.includes("props-type-unresolved") || (component.needsReview ?? false)
+    });
+  }
+  return {
+    components: validateExtractedComponents2(scoredComponents),
+    warnings
+  };
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/orchestrators/run-extract-and-compose-session/helpers/emit-pre-classification-exclusions.js
@@ -28089,68 +28565,44 @@ function SettingsScreen({
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/ConfigurationScreen.tsx
 import { useState as useState33 } from "react";
-import { Box as Box48, Text as Text51, useInput as useInput13 } from "ink";
+import { Box as Box48, Text as Text51, useInput as useInput14 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentsScreen.tsx
-import { useEffect as useEffect23, useState as useState31 } from "react";
+import { useEffect as useEffect23, useRef as useRef13, useState as useState31 } from "react";
 import { Box as Box46, Text as Text49, useInput as useInput12 } from "ink";
 init_debug_store();
 
-// packages/experience-design-system-cli/src/tui/settings/shared/v1-store.ts
+// packages/experience-design-system-cli/src/tui/settings/shared/debug-trail.ts
 init_config();
-var readV1Store = readSettings2;
-var writeV1Store = writeSettings2;
-
-// packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-store.ts
-var AGENT_LABELS = {
-  claude: "Claude Code",
-  codex: "OpenAI Codex",
-  opencode: "OpenCode",
-  cursor: "Cursor",
-  copilot: "GitHub Copilot"
-};
-var asString = (value) => typeof value === "string" ? value : "";
-function emptyAgents() {
-  return Object.fromEntries(AGENT_NAMES.map((name) => [name, { model: "", binary: "" }]));
+import { existsSync as existsSync10 } from "node:fs";
+function diffSnapshots(before, after) {
+  const names = [.../* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)])];
+  const changed_fields = names.filter((name) => before[name] !== after[name]);
+  return { changed: changed_fields.length > 0, changed_fields };
+}
+var DEFAULT_TRAIL_LIMIT = 30;
+function createTrail(limit = DEFAULT_TRAIL_LIMIT) {
+  const actions = [];
+  return {
+    record(action) {
+      actions.push(action);
+      if (actions.length > limit) actions.shift();
+    },
+    entries: () => [...actions]
+  };
 }
-async function readAgentConfig() {
-  const store = await readV1Store();
-  const stored = asString(store["agent"]);
-  const defaultChosen = isAgentName(stored);
-  const defaultAgent = defaultChosen ? stored : DEFAULT_AGENT_NAME;
-  const agents = emptyAgents();
-  const saved = store["agents"];
-  if (saved && typeof saved === "object") {
-    for (const name of AGENT_NAMES) {
-      const entry = saved[name];
-      if (entry && typeof entry === "object") {
-        const fields2 = entry;
-        agents[name] = { model: asString(fields2["model"]), binary: asString(fields2["binary"]) };
-      }
-    }
+var MIN_SECRET_LENGTH = 6;
+function scrubError(error, secrets) {
+  let message = error instanceof Error ? error.message : String(error);
+  for (const secret of secrets) {
+    if (secret.length < MIN_SECRET_LENGTH) continue;
+    for (const form of /* @__PURE__ */ new Set([secret, encodeURIComponent(secret)])) message = message.split(form).join("[redacted]");
   }
-  const legacyModel = asString(store["agentModel"]);
-  if (legacyModel && !agents[defaultAgent].model)
-    agents[defaultAgent] = { ...agents[defaultAgent], model: legacyModel };
-  return { defaultAgent, defaultChosen, agents };
+  return message;
 }
-async function writeAgentConfig(config) {
-  const existing = await readV1Store();
-  const merged = { ...existing };
-  const agents = {};
-  for (const name of AGENT_NAMES) {
-    const model = config.agents[name].model.trim();
-    const binary = config.agents[name].binary.trim();
-    if (model || binary) agents[name] = { ...model ? { model } : {}, ...binary ? { binary } : {} };
-  }
-  const defaultModel = config.defaultChosen ? agents[config.defaultAgent]?.model : void 0;
-  if (config.defaultChosen) merged["agent"] = config.defaultAgent;
-  else delete merged["agent"];
-  if (defaultModel) merged["agentModel"] = defaultModel;
-  else delete merged["agentModel"];
-  if (Object.keys(agents).length > 0) merged["agents"] = agents;
-  else delete merged["agents"];
-  await writeV1Store(merged);
+function describeSettingsFile() {
+  const path5 = configFilePath2();
+  return { path: path5, eds_home_set: Boolean(process.env["EDS_HOME"]), exists: existsSync10(path5) };
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-status.ts
@@ -28356,6 +28808,94 @@ async function withBinaryEnv(name, binary, run) {
   }
 }
 
+// packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-debug.ts
+function agentSnapshot(config) {
+  const snapshot = { default_agent: config.defaultAgent };
+  for (const name of AGENT_NAMES) {
+    snapshot[`${name}.model`] = config.agents[name].model;
+    snapshot[`${name}.binary`] = config.agents[name].binary;
+  }
+  return snapshot;
+}
+function environmentFrom(checks, savedBinary, envValue) {
+  const path5 = checks.find((check) => check.step === "path");
+  const version = checks.find((check) => check.step === "version");
+  const overridden = envValue !== void 0 && envValue !== "" && envValue !== savedBinary.trim();
+  return {
+    found: path5?.ok === true,
+    resolved_path: path5?.ok ? path5.detail : "",
+    version: version?.ok ? version.detail : "",
+    env_override: overridden ? envValue : ""
+  };
+}
+async function describeAgents(config) {
+  const entries = await Promise.all(
+    AGENT_NAMES.map(async (name) => {
+      const saved = config.agents[name].binary;
+      const checks = await inspectAgent(name, saved);
+      return [name, environmentFrom(checks, saved, process.env[`EDS_AGENT_BINARY_${name.toUpperCase()}`])];
+    })
+  );
+  return Object.fromEntries(entries);
+}
+
+// packages/experience-design-system-cli/src/tui/settings/shared/v1-store.ts
+init_config();
+var readV1Store = readSettings2;
+var writeV1Store = writeSettings2;
+
+// packages/experience-design-system-cli/src/tui/settings/configuration/agents/agent-store.ts
+var AGENT_LABELS = {
+  claude: "Claude Code",
+  codex: "OpenAI Codex",
+  opencode: "OpenCode",
+  cursor: "Cursor",
+  copilot: "GitHub Copilot"
+};
+var asString = (value) => typeof value === "string" ? value : "";
+function emptyAgents() {
+  return Object.fromEntries(AGENT_NAMES.map((name) => [name, { model: "", binary: "" }]));
+}
+async function readAgentConfig() {
+  const store = await readV1Store();
+  const stored = asString(store["agent"]);
+  const defaultChosen = isAgentName(stored);
+  const defaultAgent = defaultChosen ? stored : DEFAULT_AGENT_NAME;
+  const agents = emptyAgents();
+  const saved = store["agents"];
+  if (saved && typeof saved === "object") {
+    for (const name of AGENT_NAMES) {
+      const entry = saved[name];
+      if (entry && typeof entry === "object") {
+        const fields2 = entry;
+        agents[name] = { model: asString(fields2["model"]), binary: asString(fields2["binary"]) };
+      }
+    }
+  }
+  const legacyModel = asString(store["agentModel"]);
+  if (legacyModel && !agents[defaultAgent].model)
+    agents[defaultAgent] = { ...agents[defaultAgent], model: legacyModel };
+  return { defaultAgent, defaultChosen, agents };
+}
+async function writeAgentConfig(config) {
+  const existing = await readV1Store();
+  const merged = { ...existing };
+  const agents = {};
+  for (const name of AGENT_NAMES) {
+    const model = config.agents[name].model.trim();
+    const binary = config.agents[name].binary.trim();
+    if (model || binary) agents[name] = { ...model ? { model } : {}, ...binary ? { binary } : {} };
+  }
+  const defaultModel = config.defaultChosen ? agents[config.defaultAgent]?.model : void 0;
+  if (config.defaultChosen) merged["agent"] = config.defaultAgent;
+  else delete merged["agent"];
+  if (defaultModel) merged["agentModel"] = defaultModel;
+  else delete merged["agentModel"];
+  if (Object.keys(agents).length > 0) merged["agents"] = agents;
+  else delete merged["agents"];
+  await writeV1Store(merged);
+}
+
 // packages/experience-design-system-cli/src/tui/settings/configuration/agents/AgentDetail.tsx
 import { useEffect as useEffect22, useState as useState30 } from "react";
 import { Box as Box45, Text as Text48 } from "ink";
@@ -28557,7 +29097,8 @@ function AgentDetail({
   name,
   config,
   setConfig,
-  onBack
+  onBack,
+  record: record3
 }) {
   const settings = config.agents[name];
   const [saving, setSaving] = useState30(false);
@@ -28580,10 +29121,12 @@ function AgentDetail({
     setNotice(null);
     writeAgentConfig(config).then(() => {
       applyBinaryOverrides(config);
+      record3(`saved ${name}`);
       setNotice({ kind: "success", text: `Saved: ${AGENT_LABELS[name]} settings are written to config.json` });
-    }).catch(
-      (err) => setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` })
-    ).finally(() => setSaving(false));
+    }).catch((err) => {
+      record3(`saving ${name} failed`, err);
+      setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` });
+    }).finally(() => setSaving(false));
   };
   const runTest = () => {
     setTesting(true);
@@ -28591,12 +29134,15 @@ function AgentDetail({
     testAgent(name, settings.binary, settings.model).then((result) => {
       setChecks(result);
       const outcome = testOutcome(result);
+      if (!outcome || !outcome.ok)
+        record3(`test of ${name} failed: ${outcome?.text ?? "the agent could not be started"}`);
       setNotice(
         outcome ? { kind: outcome.ok ? "success" : "error", text: outcome.text } : { kind: "error", text: "Test not run: the agent could not be started (see Status)" }
       );
-    }).catch(
-      (err) => setNotice({ kind: "error", text: `Test could not run: ${err instanceof Error ? err.message : String(err)}` })
-    ).finally(() => setTesting(false));
+    }).catch((err) => {
+      record3(`test of ${name} could not run`, err);
+      setNotice({ kind: "error", text: `Test could not run: ${err instanceof Error ? err.message : String(err)}` });
+    }).finally(() => setTesting(false));
   };
   const action = {
     label: "Run test",
@@ -28617,6 +29163,7 @@ function AgentDetail({
       onChange: (key, value) => {
         setConfig({ ...config, agents: { ...config.agents, [name]: { ...settings, [key]: value } } });
         setNotice(null);
+        record3(`edited ${name}.${key}`);
       },
       onSave: save,
       onQuit: onBack,
@@ -28643,6 +29190,12 @@ function AgentsScreen({ onDone }) {
   const [saving, setSaving] = useState31(false);
   const [loadError, setLoadError] = useState31(null);
   const [checks, setChecks] = useState31({});
+  const visit = useRef13({
+    trail: createTrail(),
+    before: void 0,
+    environment: void 0,
+    error: ""
+  }).current;
   const inspectAll = (loaded) => {
     for (const name of AGENT_NAMES) {
       void inspectAgent(name, loaded.agents[name].binary).then(
@@ -28654,14 +29207,38 @@ function AgentsScreen({ onDone }) {
     readAgentConfig().then((loaded) => {
       setConfig(loaded);
       inspectAll(loaded);
+      visit.before = agentSnapshot(loaded);
       startDebugRun({
         flow: "settings/agents",
         step: "01-agents",
         menuOption: "Configuration > Agents",
-        inputs: { default_agent: loaded.defaultAgent }
+        inputs: { ...visit.before, default_chosen: loaded.defaultChosen ?? false }
       });
-    }).catch((err) => setLoadError(err instanceof Error ? err.message : String(err)));
+      void describeAgents(loaded).then((found) => {
+        visit.environment = found;
+      });
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      startDebugRun({ flow: "settings/agents", step: "01-agents", menuOption: "Configuration > Agents", inputs: {} });
+      setLoadError(visit.error);
+    });
   }, []);
+  const endVisit = (current) => {
+    const after = current ? agentSnapshot(current) : void 0;
+    const change = visit.before && after ? diffSnapshots(visit.before, after) : { changed: false, changed_fields: [] };
+    void finishDebugRun({
+      outputs: {
+        ...after ?? {},
+        ...change,
+        actions: visit.trail.entries(),
+        // Missing only when the user left before the probes finished.
+        ...visit.environment ? { agents: visit.environment } : {},
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
   const makeDefault = (name) => {
     if (!config || saving) return;
     if (name === config.defaultAgent) {
@@ -28673,15 +29250,16 @@ function AgentsScreen({ onDone }) {
     writeAgentConfig({ ...config, defaultAgent: name, defaultChosen: true }).then(() => {
       setConfig((current) => current ? { ...current, defaultAgent: name, defaultChosen: true } : current);
       setNotice({ kind: "success", text: `Default agent is now ${AGENT_LABELS[name]}` });
-    }).catch(
-      (err) => setNotice({
-        kind: "error",
-        text: `Default agent not changed: ${err instanceof Error ? err.message : String(err)}`
-      })
-    ).finally(() => setSaving(false));
+      visit.trail.record(`made ${name} the default`);
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
+      visit.trail.record(`making ${name} the default failed`);
+      setNotice({ kind: "error", text: `Default agent not changed: ${visit.error}` });
+    }).finally(() => setSaving(false));
   };
   useInput12((input, key) => {
     if (loadError && (key.escape || input === "q")) {
+      endVisit(null);
       onDone();
       return;
     }
@@ -28706,7 +29284,7 @@ function AgentsScreen({ onDone }) {
       return;
     }
     if (key.escape || input === "q") {
-      void finishDebugRun({ outputs: { default_agent: config.defaultAgent }, status: "success", exitMethod: "saved" });
+      endVisit(config);
       onDone();
     }
   });
@@ -28731,6 +29309,10 @@ function AgentsScreen({ onDone }) {
         name: open,
         config,
         setConfig,
+        record: (action, error) => {
+          visit.trail.record(action);
+          if (error !== void 0) visit.error = scrubError(error, []);
+        },
         onBack: () => {
           setOpen(null);
           void readAgentConfig().then((saved) => {
@@ -28797,8 +29379,8 @@ function AgentsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { useEffect as useEffect24, useState as useState32 } from "react";
-import { Box as Box47, Text as Text50 } from "ink";
+import { useEffect as useEffect24, useRef as useRef14, useState as useState32 } from "react";
+import { Box as Box47, Text as Text50, useInput as useInput13 } from "ink";
 init_debug_store();
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/project-store.ts
@@ -28827,7 +29409,7 @@ async function writeCredentials(config) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/configuration/project/ProjectScreen.tsx
-import { jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
+import { Fragment as Fragment19, jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
 var FIELDS2 = [
   { key: "spaceId", label: "Space ID" },
   { key: "environmentId", label: "Environment ID" },
@@ -28848,45 +29430,94 @@ function debugFields(config) {
     contentful_base_dir: config?.contentfulBaseDir ?? ""
   };
 }
+var snapshotOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
 var valuesOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
 function ProjectScreen({ onDone }) {
   const [config, setConfig] = useState32(null);
   const [saving, setSaving] = useState32(false);
   const [notice, setNotice] = useState32(null);
-  const [lastSaved, setLastSaved] = useState32(null);
+  const [loadError, setLoadError] = useState32(null);
+  const visit = useRef14({
+    trail: createTrail(),
+    before: void 0,
+    persisted: void 0,
+    error: ""
+  }).current;
+  const scrub = (err) => scrubError(err, [config?.cmaToken ?? ""]);
   useEffect24(() => {
-    void readCredentials().then((cfg) => {
+    readCredentials().then((cfg) => {
       setConfig(cfg);
+      visit.before = snapshotOf(cfg);
+      visit.persisted = visit.before;
+      startDebugRun({
+        flow: "settings/contentful-configuration",
+        step: "01-configuration",
+        menuOption: "Configuration > Project",
+        inputs: { ...debugFields(cfg), settings_file: describeSettingsFile() }
+      });
+    }).catch((err) => {
+      visit.error = scrubError(err, []);
       startDebugRun({
         flow: "settings/contentful-configuration",
         step: "01-configuration",
         menuOption: "Configuration > Project",
-        inputs: debugFields(cfg)
+        inputs: { settings_file: describeSettingsFile() }
       });
+      setLoadError(visit.error);
     });
   }, []);
+  const endVisit = (current) => {
+    const onScreen = current ? snapshotOf(current) : void 0;
+    const change = visit.before && visit.persisted ? diffSnapshots(visit.before, visit.persisted) : { changed: false, changed_fields: [] };
+    const unsaved = visit.persisted && onScreen ? diffSnapshots(visit.persisted, onScreen) : { changed: false, changed_fields: [] };
+    void finishDebugRun({
+      outputs: {
+        ...debugFields(current),
+        ...change,
+        unsaved_edits: unsaved.changed_fields,
+        actions: visit.trail.entries(),
+        ...visit.error ? { error: visit.error } : {}
+      },
+      status: visit.error ? "error" : "success",
+      exitMethod: change.changed ? "saved" : "discarded"
+    });
+  };
+  useInput13((input, key) => {
+    if (!config && loadError && (key.escape || input === "q")) {
+      endVisit(null);
+      onDone();
+    }
+  });
   if (!config) {
     return /* @__PURE__ */ jsxs48(Box47, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
       /* @__PURE__ */ jsx59(Text50, { bold: true, children: "Project" }),
       /* @__PURE__ */ jsx59(Text50, { children: " " }),
-      /* @__PURE__ */ jsx59(Text50, { color: PALETTE.accent, children: "Loading..." })
+      loadError ? /* @__PURE__ */ jsxs48(Fragment19, { children: [
+        /* @__PURE__ */ jsxs48(Text50, { color: PALETTE.error, children: [
+          "\u2717 Could not read the settings: ",
+          loadError
+        ] }),
+        /* @__PURE__ */ jsx59(Text50, { children: " " }),
+        /* @__PURE__ */ jsx59(ControlHints, { hints: [{ keys: "Esc/q", label: "back" }] })
+      ] }) : /* @__PURE__ */ jsx59(Text50, { color: PALETTE.accent, children: "Loading..." })
     ] });
   }
   const save = () => {
     setSaving(true);
     setNotice(null);
     writeCredentials(config).then(() => {
-      setLastSaved(config);
+      visit.persisted = snapshotOf(config);
+      visit.trail.record("saved");
       if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
       setNotice({ kind: "success", text: "Project settings saved" });
     }).catch((err) => {
+      visit.error = scrub(err);
+      visit.trail.record("save failed");
       setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" });
     }).finally(() => setSaving(false));
   };
   const quit = () => {
-    void finishDebugRun(
-      lastSaved ? { outputs: debugFields(lastSaved), status: "success", exitMethod: "saved" } : { outputs: {}, status: "success", exitMethod: "discarded" }
-    );
+    endVisit(config);
     onDone();
   };
   return /* @__PURE__ */ jsx59(
@@ -28899,6 +29530,7 @@ function ProjectScreen({ onDone }) {
       onChange: (key, value) => {
         setConfig({ ...config, [key]: value });
         setNotice(null);
+        visit.trail.record(`edited ${key}`);
       },
       onSave: save,
       onQuit: quit,
@@ -28922,7 +29554,7 @@ function ConfigurationScreen({ onDone }) {
   const [focus, setFocus] = useState33(0);
   const [open, setOpen] = useState33(null);
   const close = () => setOpen(null);
-  useInput13((input, key) => {
+  useInput14((input, key) => {
     if (open) return;
     if (key.upArrow) {
       setFocus((i) => (i - 1 + SECTIONS.length) % SECTIONS.length);
@@ -28964,7 +29596,7 @@ function ConfigurationScreen({ onDone }) {
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
 import { useEffect as useEffect25, useState as useState34 } from "react";
-import { Box as Box49, Text as Text52, useInput as useInput14 } from "ink";
+import { Box as Box49, Text as Text52, useInput as useInput15 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
 async function readAnalyticsSetting() {
@@ -28983,7 +29615,7 @@ async function writeAnalyticsSetting(setting) {
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
 init_debug_store();
-import { Fragment as Fragment19, jsx as jsx61, jsxs as jsxs50 } from "react/jsx-runtime";
+import { Fragment as Fragment20, jsx as jsx61, jsxs as jsxs50 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState34(true);
   const [enabled, setEnabled] = useState34(true);
@@ -28999,7 +29631,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput14((input, key) => {
+  useInput15((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -29017,7 +29649,7 @@ function OptInAnalyticsScreen({ onDone }) {
   return /* @__PURE__ */ jsxs50(Box49, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
     /* @__PURE__ */ jsx61(Text52, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
     /* @__PURE__ */ jsx61(Text52, { children: " " }),
-    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs50(Fragment19, { children: [
+    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs50(Fragment20, { children: [
       /* @__PURE__ */ jsxs50(Text52, { children: [
         "Share anonymous usage data:",
         " ",
@@ -29040,89 +29672,16 @@ function OptInAnalyticsScreen({ onDone }) {
   ] });
 }
 
-// packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect26, useState as useState35 } from "react";
-import { Box as Box50, Text as Text53, useInput as useInput15 } from "ink";
-init_version();
-init_debug_store();
-import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
-var UPGRADE_COMMANDS = ["git pull", "pnpm install", "pnpm build"];
-function UpgradeScreen({ onDone }) {
-  const [upgradeCheck, setUpgradeCheck] = useState35();
-  useEffect26(() => {
-    startDebugRun({
-      flow: "upgrade",
-      step: "01-upgrade",
-      menuOption: "Upgrade",
-      inputs: { currentVersion: readPackageVersion() }
-    });
-    checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
-  }, []);
-  useInput15((_input, key) => {
-    if (key.return) {
-      void finishDebugRun({
-        outputs: upgradeCheck ?? {},
-        status: upgradeCheck?.status === "error" ? "error" : "success",
-        exitMethod: "saved"
-      });
-      onDone();
-      return;
-    }
-  });
-  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Upgrade" }),
-    /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    renderBody(upgradeCheck),
-    /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.accent, children: [
-      FOCUS_MARKER,
-      " Go Back"
-    ] })
-  ] });
-}
-function renderBody(upgradeCheck) {
-  if (!upgradeCheck) {
-    return /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Checking for updates\u2026" });
-  }
-  if (upgradeCheck.status === "error") {
-    return /* @__PURE__ */ jsx62(Text53, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
-  }
-  if (upgradeCheck.status === "up-to-date") {
-    return /* @__PURE__ */ jsxs51(Text53, { color: PALETTE.success, children: [
-      "You're already on the latest version (v",
-      upgradeCheck.current,
-      ")."
-    ] });
-  }
-  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs51(Text53, { color: PALETTE.muted, children: [
-      /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.success, children: [
-        "v",
-        upgradeCheck.latest
-      ] }),
-      " ",
-      "is available (you're on ",
-      /* @__PURE__ */ jsxs51(Text53, { bold: true, children: [
-        "v",
-        upgradeCheck.current
-      ] }),
-      "). Exit this program, cd into the root of your local clone of contentful/experience-design-system-sdk-public, then run:"
-    ] }),
-    /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    /* @__PURE__ */ jsx62(Box50, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx62(Text53, { bold: true, children: cmd }, cmd)) })
-  ] });
-}
-
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect27, useState as useState36 } from "react";
-import { Box as Box51, Text as Text54, useInput as useInput16 } from "ink";
+import { useEffect as useEffect26, useState as useState35 } from "react";
+import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
-import { jsx as jsx63, jsxs as jsxs52 } from "react/jsx-runtime";
+import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState36(true);
-  const [enabled, setEnabled] = useState36(true);
-  useEffect27(() => {
+  const [loading, setLoading] = useState35(true);
+  const [enabled, setEnabled] = useState35(true);
+  useEffect26(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -29149,16 +29708,16 @@ function DebugModeScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs52(Box51, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx63(Text54, { bold: true, children: "Settings \u203A Debug Mode" }),
-    /* @__PURE__ */ jsx63(Text54, { children: " " }),
-    loading ? /* @__PURE__ */ jsx63(Text54, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs52(Text54, { children: [
+  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Settings \u203A Debug Mode" }),
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    loading ? /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs51(Text53, { children: [
       "Debug logging:",
       " ",
-      /* @__PURE__ */ jsx63(Text54, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+      /* @__PURE__ */ jsx62(Text53, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
     ] }),
-    /* @__PURE__ */ jsx63(Text54, { children: " " }),
-    /* @__PURE__ */ jsx63(
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    /* @__PURE__ */ jsx62(
       ControlHints,
       {
         hints: [
@@ -29171,18 +29730,18 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment20, jsx as jsx64 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
-  const [screen, setScreen] = useState37("start");
-  const [importExitCode, setImportExitCode] = useState37();
+  const [screen, setScreen] = useState36("start");
+  const [importExitCode, setImportExitCode] = useState36();
   const showImportResult = importExitCode !== void 0;
-  const [projectPath, setProjectPath] = useState37();
-  const [tokensPath, setTokensPath] = useState37();
-  const [scannedFiles, setScannedFiles] = useState37();
-  const [pendingLaunch, setPendingLaunch] = useState37();
-  const [extractionRun, setExtractionRun] = useState37();
+  const [projectPath, setProjectPath] = useState36();
+  const [tokensPath, setTokensPath] = useState36();
+  const [scannedFiles, setScannedFiles] = useState36();
+  const [pendingLaunch, setPendingLaunch] = useState36();
+  const [extractionRun, setExtractionRun] = useState36();
   const extraction = useExtraction(extractionRun?.input);
-  const [scopeRun, setScopeRun] = useState37();
+  const [scopeRun, setScopeRun] = useState36();
   const scopeFlow = useScopeGateFlow(
     scopeRun && {
       sessionId: scopeRun.extraction.sessionId,
@@ -29197,12 +29756,12 @@ function App({ importOptions, inkClear }) {
       }
     }
   );
-  const [generationInput, setGenerationInput] = useState37();
+  const [generationInput, setGenerationInput] = useState36();
   const generation = useGeneration(generationInput);
-  const [flowStart, setFlowStart] = useState37();
+  const [flowStart, setFlowStart] = useState36();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
-  const [importDefaults, setImportDefaults] = useState37();
-  useEffect28(() => {
+  const [importDefaults, setImportDefaults] = useState36();
+  useEffect27(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -29262,12 +29821,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect28(() => {
+  useEffect27(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect28(() => {
+  useEffect27(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -29285,7 +29844,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect28(() => {
+  useEffect27(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -29328,9 +29887,9 @@ function App({ importOptions, inkClear }) {
   };
   switch (screen) {
     case "import":
-      if (showImportResult) return /* @__PURE__ */ jsx64(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
+      if (showImportResult) return /* @__PURE__ */ jsx63(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
       if (flow && flowStart) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           FlowScreen,
           {
             state: flow.state,
@@ -29340,12 +29899,12 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx64(Fragment20, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
       if (projectPath === void 0) {
-        return /* @__PURE__ */ jsx64(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
+        return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
       if (tokensPath === void 0) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           TokenInputScreen,
           {
             initialPath: importDefaults.tokenFile,
@@ -29355,7 +29914,7 @@ function App({ importOptions, inkClear }) {
         );
       }
       if (scannedFiles === void 0) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           PathValidationScreen,
           {
             projectPath,
@@ -29367,10 +29926,10 @@ function App({ importOptions, inkClear }) {
       }
       if (extractionRun) {
         if (extraction?.status === "done" && !extraction.result.ok) {
-          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx63(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
         }
         if (extraction?.status === "running") {
-          return /* @__PURE__ */ jsx64(
+          return /* @__PURE__ */ jsx63(
             ExtractionScreen,
             {
               progress: extraction.progress,
@@ -29379,14 +29938,14 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx64(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
-          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx63(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
         }
         if (scopeFlow.status === "deciding") {
-          return /* @__PURE__ */ jsx64(
+          return /* @__PURE__ */ jsx63(
             ScopeGateScreen,
             {
               components: scopeFlow.load.components,
@@ -29396,7 +29955,7 @@ function App({ importOptions, inkClear }) {
           );
         }
         if (generation?.status === "done" && !generation.result.ok) {
-          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx63(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
         }
         if (generation?.status === "running") {
           const hasRawTokens = scopeRun.input.rawTokensPath !== "";
@@ -29404,7 +29963,7 @@ function App({ importOptions, inkClear }) {
             hasRawTokens,
             mapTokensEligible: generation.progress.mapTokensEligible
           });
-          return /* @__PURE__ */ jsx64(
+          return /* @__PURE__ */ jsx63(
             GenerationScreen,
             {
               progress: generation.progress,
@@ -29416,10 +29975,10 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx64(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (pendingLaunch?.cached) {
-        return /* @__PURE__ */ jsx64(
+        return /* @__PURE__ */ jsx63(
           TokenReuseScreen,
           {
             tokensPath: pendingLaunch.cached.tokensPath,
@@ -29430,7 +29989,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      return /* @__PURE__ */ jsx64(
+      return /* @__PURE__ */ jsx63(
         CredentialsScreen,
         {
           initial: importDefaults.credentials,
@@ -29439,19 +29998,17 @@ function App({ importOptions, inkClear }) {
         }
       );
     case "help":
-      return /* @__PURE__ */ jsx64(HelpScreen, { onDone: goToStart });
-    case "upgrade":
-      return /* @__PURE__ */ jsx64(UpgradeScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx63(HelpScreen, { onDone: goToStart });
     case "settings":
-      return /* @__PURE__ */ jsx64(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
+      return /* @__PURE__ */ jsx63(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
     case "settings-configuration":
-      return /* @__PURE__ */ jsx64(ConfigurationScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx63(ConfigurationScreen, { onDone: goToSettings });
     case "settings-opt-in-analytics":
-      return /* @__PURE__ */ jsx64(OptInAnalyticsScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx63(OptInAnalyticsScreen, { onDone: goToSettings });
     case "settings-debug-mode":
-      return /* @__PURE__ */ jsx64(DebugModeScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx63(DebugModeScreen, { onDone: goToSettings });
     case "start":
-      return /* @__PURE__ */ jsx64(HomeScreen, { onNavigate: setScreen });
+      return /* @__PURE__ */ jsx63(HomeScreen, { onNavigate: setScreen });
   }
 }
 async function runApp(renderApp, importOptions) {
@@ -29459,7 +30016,7 @@ async function runApp(renderApp, importOptions) {
     instance.clear?.();
     process.stdout.write("\x1B[H\x1B[0J");
   };
-  const instance = renderApp(/* @__PURE__ */ jsx64(App, { importOptions, inkClear }));
+  const instance = renderApp(/* @__PURE__ */ jsx63(App, { importOptions, inkClear }));
   await instance.waitUntilExit();
 }
 export {