@contentful/experience-design-system-cli 2.37.1-dev-build-0b7e3e1f.0 → 2.37.1-dev-build-414ce827.0

package/dist/app.js

@@ -9648,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;
@@ -12919,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
@@ -15335,7 +15335,610 @@ 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
+// 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-extraction/dist/src/extract/framework-adapters/shared/helpers/tsx-shared.js
+import { Project as Project8 } from "ts-morph";
+
+// 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-extraction/dist/src/extract/framework-adapters/shared/helpers/resolve-tsx-workspace-imports.js
+import { Node as Node11 } from "ts-morph";
+
+// 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-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
+    }
+  ];
+}
+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"]
+    }
+  ],
+  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
+    }
+  ],
+  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
+    }
+  ],
+  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 {
+    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-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("'");
+}
+function isSimpleType(type) {
+  const t = type.trim();
+  if (t === "string" || t === "boolean" || t === "number")
+    return true;
+  return isStringLiteralUnion(t);
+}
+function isBooleanType(type) {
+  return type.trim() === "boolean";
+}
+function isStringType(type) {
+  return type.trim() === "string";
+}
+function isNumberType(type) {
+  return type.trim() === "number";
+}
+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",
+  "class",
+  "classes",
+  "classNames",
+  "rootClassName",
+  "prefixCls",
+  "style",
+  "styles",
+  // Bare HTML attributes
+  "id",
+  "role",
+  "tabIndex",
+  "tabindex",
+  "htmlFor",
+  "for",
+  "slot",
+  "is",
+  "lang",
+  "dir",
+  "hidden",
+  "draggable",
+  "spellCheck",
+  "spellcheck",
+  "contentEditable",
+  "contenteditable",
+  "inputMode",
+  "inputmode",
+  "autoComplete",
+  "autocomplete",
+  "autoFocus",
+  "autofocus",
+  "translate",
+  "part",
+  "exportparts",
+  "aria",
+  // Framework theming / pass-through escape hatches — dev-facing, never marketer-configurable
+  "dt",
+  "pt",
+  "ptOptions",
+  "unstyled",
+  "sx",
+  // Polymorphic component props — change rendered HTML/component, not marketer-visible behavior
+  "as",
+  "element",
+  "component",
+  // QA / vendor test attributes
+  "dataQa",
+  "data-qa",
+  // Vue v-model internals — framework wiring, never marketer-configurable
+  "modelValue",
+  "modelModifiers"
+]);
+function isDomPassThroughProp(name) {
+  if (DOM_PASS_THROUGH_PROPS.has(name))
+    return true;
+  if (/^aria[-A-Z]/.test(name))
+    return true;
+  return name.startsWith("data-");
+}
+
+// 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) {
@@ -15388,15 +15991,10 @@ function hasNoAuthoringSurface(component) {
   return { skip: false };
 }
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/evidence/source-inspection.js
+// 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-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-backend-pipeline/dist/src/steps/extraction/src/framework-adapters/shared/parse-imported-names.js
+// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/parse-source-imports.js
 function parseImportedNames(importClause) {
   const trimmed = importClause.trim();
   if (!trimmed)
@@ -15421,7 +16019,7 @@ function parseImportedNames(importClause) {
   return names;
 }
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/evidence/source-inspection.js
+// 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[^'"]*['"]/;
@@ -15463,11 +16061,11 @@ function hasSiblingForwardRender(sourceText, siblingImports) {
 function hasVisibleUiRender(sourceText) {
   return /return\s*(?:\(|<)/.test(sourceText) && VISIBLE_UI_TAG_PATTERN.test(sourceText);
 }
-function infraPropNames(component) {
+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 scoreToConfidence(score) {
+function mapScoreToWrapperConfidence(score) {
   if (score <= 0)
     return 0;
   if (score <= 2)
@@ -15478,9 +16076,14 @@ function scoreToConfidence(score) {
     return 4;
   return 5;
 }
-function dedupeReasons(reasons) {
-  return [...new Set(reasons)];
+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 {
@@ -15495,7 +16098,7 @@ async function inspectComponentSource(component) {
   const reviewReasons = [];
   let wrapperScore = 0;
   const hasGeneratedQueryHook = GENERATED_IMPORT_PATTERN.test(sourceText) && GENERATED_QUERY_HOOK_PATTERN.test(sourceText);
-  const infraProps = infraPropNames(component);
+  const infraProps = collectInfraPropNames(component);
   const siblingImports = collectSiblingRendererImports(sourceText);
   if (GQL_FILENAME_PATTERN.test(component.source)) {
     reviewReasons.push("data-wrapper:gql-filename");
@@ -15525,7 +16128,7 @@ async function inspectComponentSource(component) {
     reviewReasons.push("data-wrapper:loading-null-guard");
     wrapperScore += 1;
   }
-  const wrapperConfidence = scoreToConfidence(wrapperScore);
+  const wrapperConfidence = mapScoreToWrapperConfidence(wrapperScore);
   if (wrapperConfidence >= 4) {
     reviewReasons.unshift(HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON);
   } else if (wrapperConfidence === 3) {
@@ -15537,7 +16140,7 @@ async function inspectComponentSource(component) {
   }
   return {
     wrapperConfidence,
-    reviewReasons: dedupeReasons(reviewReasons),
+    reviewReasons: dedupeStrings(reviewReasons),
     keepDespiteZeroSurface
   };
 }
@@ -15568,235 +16171,123 @@ function describeReviewReason(reason) {
   }
 }
 function describeReviewReasons(reasons) {
-  return dedupeReasons(reasons.map(describeReviewReason));
-}
-
-// 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;
-}
-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})`);
-    }
-    if (keepDespiteZeroSurface) {
-      warnings.push(`${component.name}: retained despite 0 props/slots because the source renders visible or compositional UI`);
-    }
-    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}`);
-    }
-    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)
-    });
-  }
-  return {
-    components: validateExtractedComponents(scoredComponents),
-    warnings
-  };
+  return dedupeStrings(reasons.map(describeReviewReason));
 }
 
-// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/pre-classify.js
-function isStringLiteralUnion(type) {
-  return type.includes("|") && type.includes("'");
-}
-function isSimpleType(type) {
-  const t = type.trim();
-  if (t === "string" || t === "boolean" || t === "number")
-    return true;
-  return isStringLiteralUnion(t);
-}
-function isBooleanType(type) {
-  return type.trim() === "boolean";
-}
-function isStringType(type) {
-  return type.trim() === "string";
-}
-function isNumberType(type) {
-  return type.trim() === "number";
-}
-function isComplexType(type) {
-  return !isSimpleType(type);
-}
-var DOM_PASS_THROUGH_PROPS = /* @__PURE__ */ new Set([
-  // Bare HTML / framework styling pass-through
-  "className",
-  "class",
-  "classes",
-  "classNames",
-  "rootClassName",
-  "prefixCls",
-  "style",
-  "styles",
-  // Bare HTML attributes
-  "id",
-  "role",
-  "tabIndex",
-  "tabindex",
-  "htmlFor",
-  "for",
-  "slot",
-  "is",
-  "lang",
-  "dir",
-  "hidden",
-  "draggable",
-  "spellCheck",
-  "spellcheck",
-  "contentEditable",
-  "contenteditable",
-  "inputMode",
-  "inputmode",
-  "autoComplete",
-  "autocomplete",
-  "autoFocus",
-  "autofocus",
-  "translate",
-  "part",
-  "exportparts",
-  "aria",
-  // Framework theming / pass-through escape hatches — dev-facing, never marketer-configurable
-  "dt",
-  "pt",
-  "ptOptions",
-  "unstyled",
-  "sx",
-  // Polymorphic component props — change rendered HTML/component, not marketer-visible behavior
-  "as",
-  "element",
-  "component",
-  // QA / vendor test attributes
-  "dataQa",
-  "data-qa",
-  // Vue v-model internals — framework wiring, never marketer-configurable
-  "modelValue",
-  "modelModifiers"
-]);
-function isDomPassThroughProp(name) {
-  if (DOM_PASS_THROUGH_PROPS.has(name))
-    return true;
-  if (/^aria[-A-Z]/.test(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" };
-  }
-  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" };
+// 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 (!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" };
+  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 (isBooleanType(type)) {
-    const stateNames = ["disabled", "loading", "expanded", "isOpen", "selected", "checked", "active", "preview"];
-    if (stateNames.includes(name)) {
-      return { category: "state", cdfTypeHint: "boolean" };
+    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`
+        });
+      }
     }
-  }
-  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" };
+    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`
+        });
+      }
     }
-  }
-  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" };
+    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`
+        });
+      }
     }
-  }
-  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" };
+    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 (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;
+    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 };
+  });
 }
-function preClassifyComponent(component) {
-  const props = component.props.flatMap((prop) => {
-    const result = preClassifyProp(prop);
-    if (result?.category === "exclude") {
-      return [];
+
+// 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;
+}
+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
@@ -28074,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
@@ -28341,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";
@@ -28542,7 +29097,8 @@ function AgentDetail({
   name,
   config,
   setConfig,
-  onBack
+  onBack,
+  record: record3
 }) {
   const settings = config.agents[name];
   const [saving, setSaving] = useState30(false);
@@ -28565,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);
@@ -28576,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",
@@ -28602,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,
@@ -28628,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(
@@ -28639,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) {
@@ -28658,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;
     }
@@ -28691,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();
     }
   });
@@ -28716,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) => {
@@ -28782,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
@@ -28812,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" },
@@ -28833,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(
@@ -28884,6 +29530,7 @@ function ProjectScreen({ onDone }) {
       onChange: (key, value) => {
         setConfig({ ...config, [key]: value });
         setNotice(null);
+        visit.trail.record(`edited ${key}`);
       },
       onSave: save,
       onQuit: quit,
@@ -28907,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);
@@ -28949,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() {
@@ -28968,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);
@@ -28984,7 +29631,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput14((input, key) => {
+  useInput15((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -29002,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:",
         " ",
@@ -29027,7 +29674,7 @@ function OptInAnalyticsScreen({ onDone }) {
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
 import { useEffect as useEffect26, useState as useState35 } from "react";
-import { Box as Box50, Text as Text53, useInput as useInput15 } from "ink";
+import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
 import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
@@ -29046,7 +29693,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput15((input, key) => {
+  useInput16((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -29083,7 +29730,7 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment20, jsx as jsx63 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState36("start");
   const [importExitCode, setImportExitCode] = useState36();
@@ -29252,7 +29899,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment20, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
       if (projectPath === void 0) {
         return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
@@ -29291,7 +29938,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
@@ -29328,7 +29975,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment20, {});
+        return /* @__PURE__ */ jsx63(Fragment21, {});
       }
       if (pendingLaunch?.cached) {
         return /* @__PURE__ */ jsx63(