@adia-ai/a2ui 0.8.37 → 0.8.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui",
-  "version": "0.8.37",
+  "version": "0.8.39",
   "description": "The A2UI protocol — runtime (renderer, registry, streams, surface manifest, wiring primitives, dockable base classes) plus protocol-side validation. Framework-agnostic and dependency-free; pairs with any A2UI-conformant component set. Folded from @adia-ai/a2ui-runtime + the protocol half of @adia-ai/a2ui-validator (ADR-0048).",
   "type": "module",
   "exports": {
@@ -56,10 +56,31 @@
       "types": "./validate/index.d.ts",
       "import": "./validate/index.js",
       "default": "./validate/index.js"
+    },
+    "./catalog": {
+      "types": "./catalog/catalog-a2ui_0_9.d.ts",
+      "import": "./catalog/catalog-a2ui_0_9.json",
+      "default": "./catalog/catalog-a2ui_0_9.json"
+    },
+    "./catalog/tiers": {
+      "types": "./catalog/tier-index.d.ts",
+      "import": "./catalog/tier-index.json",
+      "default": "./catalog/tier-index.json"
+    },
+    "./catalog/common-types": {
+      "types": "./catalog/common_types.d.ts",
+      "import": "./catalog/common_types.json",
+      "default": "./catalog/common_types.json"
+    },
+    "./catalog/functions": {
+      "types": "./catalog/functions.d.ts",
+      "import": "./catalog/functions.json",
+      "default": "./catalog/functions.json"
     }
   },
   "files": [
     "*.js",
+    "catalog/",
     "dockables/",
     "controllers/",
     "validate/index.js",
@@ -81,7 +102,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/adiahealth/gen-ui-kit.git",
-    "directory": "packages/a2ui"
+    "directory": "packages/gen-ui/a2ui"
   },
   "devDependencies": {
     "@adia-ai/gen-ui": "^0.8.0"

package/registry.js

@@ -112,6 +112,7 @@ export const registry = new Map([
 
   // Navigation
   ['Breadcrumb',       'breadcrumb-ui'],
+  ['Drilldown',        'drilldown-ui'],
   ['Link',             'link-ui'],
   ['Anchor',           'link-ui'],
   ['Hyperlink',        'link-ui'],

package/validate/CHANGELOG.md

@@ -763,54 +763,54 @@ _No pending changes._
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.8` (§80 event-types codegen for 38 non-form primitives + §85 class-subpath script fix + §89 icons.js split + B+C+D consumer-friction infra), `@adia-ai/web-modules@0.4.8` (FEEDBACK-02 #1 `.d.ts` shipment + `composes:` ADR-0027 wiring), `@adia-ai/a2ui-compose@0.4.8` (§87 zettel `ensureBooted()` race fix + §88 free-form composition mode), `@adia-ai/a2ui-corpus@0.4.8` (catalog regen ride-along), `@adia-ai/a2ui-mcp@0.4.8` (§87 eval threshold rebaseline). Source byte-identical to v0.4.7.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.8]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.8]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.7] - 2026-05-12
 
 ### Ride-along (no source changes)
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.7` (§74 `.d.ts` codegen for 73 non-form primitives + §77 non-side-effect `class` subpath per component + class.js helper extractions in agent + toolbar primitives), `@adia-ai/web-modules@0.4.7`, `@adia-ai/a2ui-compose@0.4.7` (§72 `getComponentCatalog()` reads canonical catalog), `@adia-ai/a2ui-corpus@0.4.7` (§72 `corpus/patterns/` + `corpus/compositions/` retired from disk + tarball — v0.4.6 §65 carry-over closed), `@adia-ai/a2ui-mcp@0.4.7`, `@adia-ai/a2ui-retrieval@0.4.7` (§72 vocab reads canonical catalog + dead pattern-embeddings retired). Source byte-identical to v0.4.6.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.7]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.7]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.6] - 2026-05-12
 
 ### Ride-along (no source changes)
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.6` (§68 .d.ts shipment + USAGE.md + `defineIfFree` + NEW `<toggle-scheme-ui>` primitive + `<pane-ui>` resize tracking 1:1), `@adia-ai/web-modules@0.4.6` (`<editor-sidebar>` resize-state detection widened via `:has()`), `@adia-ai/a2ui-compose@0.4.6` (§66 canonical `.a2ui.json` sidecars in `buildSystemPrompt` + §64 composition-library canonical retrieval), `@adia-ai/a2ui-corpus@0.4.6` (§63 settings-admin-page Mode A + 12 antipattern fixes + chunk re-harvest), `@adia-ai/a2ui-retrieval@0.4.6` (§64 pattern-library retirement, consumers migrated to composition-library), `@adia-ai/a2ui-mcp@0.4.6` (§64 step 5 patterns surface retired from server.js + eval-fix.mjs). Source byte-identical to v0.4.5.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.6]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.6]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.5] - 2026-05-12
 
 ### Ride-along (no source changes)
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.5` (§61 CSS subpath exports + CustomEvent.detail sweep across 17 form-bearing primitives + slider reactivity test lock-in + §52 design-tokens export module + UI), `@adia-ai/web-modules@0.4.5` (§61 CSS subpath exports — six cluster `*.css` exports), `@adia-ai/a2ui-compose@0.4.5` (§56 system-prompt CORPUS CONTEXT block in monolithic strategies), `@adia-ai/llm@0.4.5` (§54 doc-comment path refresh). Source byte-identical to v0.4.4.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.5]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.5]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.4] - 2026-05-12
 
 ### Ride-along (no source changes)
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.4` (14 yaml gap closures from corpus simplification arc), `@adia-ai/a2ui-runtime@0.4.4` (registry expansion +27 web-modules + renderer kebab-case fix), `@adia-ai/a2ui-compose@0.4.4` (composition-library rename + transpiler `<a>` → Link), `@adia-ai/a2ui-corpus@0.4.4` (corpus simplification arc §36–§51), `@adia-ai/a2ui-mcp@0.4.4` (`get_fragment` tool retirement). Source byte-identical to v0.4.3.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.4]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.4]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.3] - 2026-05-11
 
 ### Ride-along (no source changes)
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.3` (input-ui type=number locale + thousands grouping + hold-to-repeat) + `@adia-ai/a2ui-compose@0.4.3` + `@adia-ai/a2ui-retrieval@0.4.3` (process.env browser-compat fix) + `@adia-ai/a2ui-corpus@0.4.3` (catalog regen + chunks re-harvest with new settings-appearance pattern). Source byte-identical to v0.4.2.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.3]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.2] - 2026-05-11
 
 ### Ride-along (no source changes)
 
 Lockstep PATCH cut alongside `@adia-ai/web-components@0.4.2` (`<input-ui type="number">` rewrite drops native `<input type=number>` wrapping) + `@adia-ai/web-modules@0.4.2` (`<editor-sidebar>` grid-track width-mirror fix). Source byte-identical to v0.4.1.
 
-Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.2]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). See root [CHANGELOG.md `## [0.4.2]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.1] - 2026-05-10
 
 ### Added
 
-- **Semantic-validator Phase 3 foundation** (per [.claude/docs/specs/semantic-validator.md](../../../.claude/docs/specs/semantic-validator.md) § Phase 3 — rule-based fast-path):
+- **Semantic-validator Phase 3 foundation** (per [.claude/docs/specs/semantic-validator.md](../../../../.claude/docs/specs/semantic-validator.md) § Phase 3 — rule-based fast-path):
   - `semantic/intent-specs.js` — registry of 10 `IntentSpec` entries covering dominant intent classes: `auth.signup`, `auth.signin`, `auth.password-reset`, `dashboard.analytics`, `data-table.list`, `form.settings`, `form.contact`, `chat.conversation`, `commerce.cart`, `errors.not-found`.
   - `semantic/classify-intent.js` — `classifyIntent()` regex classifier + `scoreAgainstSpec()` deterministic A2UI-tree scorer. Returns rule verdict with certainty 0..1 (≥ 0.9 = LLM-skip eligible per spec § 3c hybrid).
   - 18 unit tests covering registry hygiene, regex match against 6 dominant intents, clean-pass / clean-fail / partial-verdict scoring, nested A2UI tree traversal.
@@ -828,25 +828,25 @@ Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4
 
 Lockstep MINOR cut alongside `@adia-ai/web-modules@0.4.0` (ADR-0024 legacy shell shapes retired). Source byte-identical to v0.3.6.
 
-Internal `@adia-ai/*` dep ranges bumped from `^0.3.0` to `^0.4.0`. See root [CHANGELOG.md `## [0.4.0]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges bumped from `^0.3.0` to `^0.4.0`. See root [CHANGELOG.md `## [0.4.0]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.3.6] - 2026-05-10
 
 ### Ride-along (no source changes)
 
-Lockstep version bump only — source byte-identical to v0.3.5. Internal `@adia-ai/*` dep ranges remain at `^0.3.0`. See root [CHANGELOG.md `## [0.3.6]`](../../../CHANGELOG.md) for the cut narrative.
+Lockstep version bump only — source byte-identical to v0.3.5. Internal `@adia-ai/*` dep ranges remain at `^0.3.0`. See root [CHANGELOG.md `## [0.3.6]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.3.5] - 2026-05-07
 
 ### Ride-along (no source changes)
 
-Lockstep version bump only — source byte-identical to v0.3.4. Internal `@adia-ai/*` dep ranges remain at `^0.3.0`. See root [CHANGELOG.md `## [0.3.5]`](../../../CHANGELOG.md) for the cut narrative.
+Lockstep version bump only — source byte-identical to v0.3.4. Internal `@adia-ai/*` dep ranges remain at `^0.3.0`. See root [CHANGELOG.md `## [0.3.5]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.3.4] - 2026-05-07
 
 ### Ride-along (no source changes)
 
-Lockstep version bump only — source byte-identical to v0.3.3. Internal `@adia-ai/*` dep ranges remain at `^0.3.0`. See root [CHANGELOG.md `## [0.3.4]`](../../../CHANGELOG.md) for the cut narrative.
+Lockstep version bump only — source byte-identical to v0.3.3. Internal `@adia-ai/*` dep ranges remain at `^0.3.0`. See root [CHANGELOG.md `## [0.3.4]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.3.3] - 2026-05-07
 
-**Lockstep cut.** All 9 published `@adia-ai/*` packages now share version `0.3.3`, governed by [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
+**Lockstep cut.** All 9 published `@adia-ai/*` packages now share version `0.3.3`, governed by [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 
 ### Changed
 
@@ -859,7 +859,7 @@ Lockstep version bump only — source byte-identical to v0.3.3. Internal `@adia-
 ## [0.3.2] - 2026-05-06
 
 **9-package lockstep patch cut to v0.3.2.** All lockstep members share
-one version per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
+one version per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
 
 ### No source changes
@@ -872,7 +872,7 @@ version only.
 - `version`: `0.3.1` → `0.3.2`.
 ## [0.3.1] - 2026-05-06
 
-**9-package lockstep patch cut.** All 9 published `@adia-ai/*` packages bump 0.3.0 → 0.3.1 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.3.0` (covers `0.3.1` under semver — patch-cut asymmetry).
+**9-package lockstep patch cut.** All 9 published `@adia-ai/*` packages bump 0.3.0 → 0.3.1 per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.3.0` (covers `0.3.1` under semver — patch-cut asymmetry).
 
 This package itself ships **no source changes** in v0.3.1. The cut bumps version only — substantive content lives in [`@adia-ai/web-components`](https://github.com/adiahealth/gen-ui-kit/releases/tag/web-components-v0.3.1) (folder-per-trait restructure; barrel API unchanged).
 
@@ -882,7 +882,7 @@ This package itself ships **no source changes** in v0.3.1. The cut bumps version
 - Internal `@adia-ai/*` dep ranges: unchanged at `^0.3.0` (covers `0.3.1` under semver — patch-cut asymmetry).
 ## [0.3.0] - 2026-05-05
 
-**9-package lockstep cut.** All 9 published `@adia-ai/*` packages bump 0.2.5 → 0.3.0 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges bump `^0.2.0` → `^0.3.0`.
+**9-package lockstep cut.** All 9 published `@adia-ai/*` packages bump 0.2.5 → 0.3.0 per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges bump `^0.2.0` → `^0.3.0`.
 
 The lockstep policy expanded from 8 to 9 packages with this cut — `@adia-ai/llm` joins as a 9th member, and `@adia-ai/a2ui-utils` was renamed to `@adia-ai/a2ui-runtime`. This package's `dependencies` updated accordingly.
 
@@ -894,7 +894,7 @@ This package itself ships **no source changes** in v0.3.0. The cut bumps version
 - `version`: `0.2.5` → `0.3.0`.
 ## [0.2.5] - 2026-05-04
 
-**8-package lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.4 → 0.2.5 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.5 under semver — patch-cut asymmetry).
+**8-package lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.4 → 0.2.5 per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.5 under semver — patch-cut asymmetry).
 
 This is a **patch cut on top of v0.2.4, no BREAKING changes.** Substantive content lives in `web-components` (new `<fields-ui>` form-grid primitive + `draggable-list-item` last-item drop-zone fix, both surfaced by the Tasks UI Playground at `.claude/docs/projects/tasks-playground/`); `a2ui-corpus` ships a catalog regen for the new `<fields-ui>` yaml. `a2ui-validator` rides along at version bump only — no source change.
 
@@ -904,7 +904,7 @@ This is a **patch cut on top of v0.2.4, no BREAKING changes.** Substantive conte
 - Internal `@adia-ai/*` dep ranges: unchanged at `^0.2.0` (covers `0.2.5` under semver — patch-cut asymmetry).
 ## [0.2.4] - 2026-05-04
 
-**8-package lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.3 → 0.2.4 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.4 under semver — patch-cut asymmetry).
+**8-package lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.3 → 0.2.4 per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.4 under semver — patch-cut asymmetry).
 
 This is a **patch cut on top of v0.2.3, no BREAKING changes.** Substantive content lives in `web-components` (Tier 4 trait library lift, 11 new traits + 2 architectural rewrites, plus accumulated bug fixes); `a2ui-corpus` ships a catalog regen for the new `<demo-toggle-ui>` primitive. Six packages ride along at version + dep-range bump.
 
@@ -924,7 +924,7 @@ _Nothing yet._
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages bump
 0.2.2 → 0.2.3 per
-[`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
+[`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 Patch cut — no breaking changes.
 
 ### Changed
@@ -936,7 +936,7 @@ Patch cut — no breaking changes.
 `@adia-ai/a2ui-validator` source is byte-identical to `0.2.2`. The cut bumps version only.
 ## [0.2.2] - 2026-05-02
 
-**Lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.1 → 0.2.2 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
+**Lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.1 → 0.2.2 per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
 
 ### Changed
 
@@ -949,7 +949,7 @@ Patch cut — no breaking changes.
 ---
 ## [0.2.1] - 2026-05-02
 
-**Lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.0 → 0.2.1 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
+**Lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.0 → 0.2.1 per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
 
 ### Changed
 
@@ -964,7 +964,7 @@ Patch cut — no breaking changes.
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages now share one
 version, governed by [`.claude/docs/specs/package-architecture.md` § 15
-(Versioning Policy)](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
+(Versioning Policy)](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 
 ### Changed
 
@@ -981,7 +981,7 @@ bumps version + the internal dep range only.
 ## [0.0.1] - 2026-04-24
 
 First public release. Extracted from
-[`@adia-ai/a2ui-compose`](../../gen-ui/compose/) during the 2026-04-24
+[`@adia-ai/a2ui-compose`](../../engine/compose/) during the 2026-04-24
 consolidation.
 
 ### Included

package/validate/README.md

@@ -11,7 +11,7 @@ JSON Schema structural validation for A2UI (Agent-to-UI) protocol messages —
 shape, types, required fields, and wiring/registry coherence. Its only import
 is this package's own registry, which is what lets `@adia-ai/a2ui` ship with
 zero dependencies. Originally extracted from
-[`@adia-ai/a2ui-compose`](../../gen-ui/compose/) so non-compose tooling
+[`@adia-ai/a2ui-compose`](../../engine/compose/) so non-compose tooling
 (tests, MCP validator tools, CI gates) could depend on validation without
 pulling the full generator graph.
 
@@ -53,19 +53,24 @@ const result = validateAgainstCatalog(messages, catalog);
 
 ## Catalog loading + degradation (gh#742, gh#748)
 
+> ⚠️ The catalog validator itself lives in `@adia-ai/gen-ui`
+> (`./validate/catalog`) — this section describes its load chain because the
+> catalog it loads now ships from THIS package (`@adia-ai/a2ui/catalog`,
+> ADR-0050).
+
 The catalog validator needs the v0.9 component catalog. **First try is the bare
-specifier `@adia-ai/a2ui-corpus`** — that package's `.` export IS
-`catalog-a2ui_0_9.json`, and it is a declared dependency of this package, so a
-plain `npm i @adia-ai/a2ui-validator` install resolves it with no repo layout,
+specifier `@adia-ai/a2ui/catalog`** — that subpath IS
+`catalog-a2ui_0_9.json`, and `@adia-ai/a2ui` is a declared dependency of
+`@adia-ai/gen-ui`, so a plain `npm i` resolves it with no repo layout,
 no static asset server and no bundler config (gh#748: before this, every
-tarball consumer validated in degraded mode, because all three fallbacks below
-resolve `../corpus/...` relative to this module and only work through workspace
+tarball consumer validated in degraded mode, because all the fallbacks below
+resolve relative to the module and only work through workspace
 symlinks). On Node, a `createRequire(...).resolve()` + `fs.readFile` retry
 covers runtimes that reject JSON import attributes (`source: 'package-fs'`).
 
 The relative-path chain stays as the in-repo / browser fallback. Node reads it
 from disk; the browser **fetches** it module-relative
-(`fetch(new URL('../corpus/catalog-a2ui_0_9.json', import.meta.url))`) — the
+(`fetch(new URL('../../a2ui/catalog/catalog-a2ui_0_9.json', import.meta.url))`) — the
 same idiom as `retrieval/catalog.js` and `compose/strategies/monolithic/_shared.js`.
 A spec-correct `import(..., { with: { type: 'json' } })` cannot be the primary
 path: Vite's dev server serves JSON as `text/javascript` and the browser's
@@ -129,7 +134,7 @@ score) and sum to 13: `wiringControllersExist` (3), `wiringHostsExist`
   `dominantPattern` (0.5 weight) + `requiredCapabilities` (0.35) +
   `forbiddenNoise` (0.15). Combined-gating opt-in via
   `--gate-mode combined` to the eval harness.
-- **Phases 3–5** — planned per [`semantic-validator.md`](../../../.claude/docs/specs/semantic-validator.md):
+- **Phases 3–5** — planned per [`semantic-validator.md`](../../../../.claude/docs/specs/semantic-validator.md):
   rubric expansion, persisted per-intent thresholds, and judge
   ensembling.
 
@@ -140,7 +145,7 @@ score) and sum to 13: `wiringControllersExist` (3), `wiringHostsExist`
 
 ## Related
 
-- Spec: [`.claude/docs/specs/semantic-validator.md`](../../../.claude/docs/specs/semantic-validator.md) — canonical design narrative
+- Spec: [`.claude/docs/specs/semantic-validator.md`](../../../../.claude/docs/specs/semantic-validator.md) — canonical design narrative
 - Audit: `.claude/docs/reports/audit-validator-2026-05-06.md` — 226-line deep-dive with check-by-check rationale + recalibration notes
 - Repo: [`adiahealth/gen-ui-kit`](https://github.com/adiahealth/gen-ui-kit)
 - CHANGELOG: [`CHANGELOG.md`](./CHANGELOG.md)