@adia-ai/gen-ui 0.8.37 → 0.8.38

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog — @adia-ai/gen-ui
 
+## [0.8.38] — 2026-08-15
+
+### Removed
+- **BREAKING: the `./corpus` root export is gone — the catalog it resolved to now ships from `@adia-ai/a2ui/catalog` (ADR-0050, gh#1243).** `import catalog from '@adia-ai/gen-ui/corpus'` becomes `import catalog from '@adia-ai/a2ui/catalog'`, which needs only the zero-dependency protocol package. Every `./corpus/*` subpath (`chunks`, `chunks/*`, `manifest`, `chunk-embeddings`, `chunk-library`) is UNCHANGED: those are corpus fuel and they stay here. The catalog's authoring sources (`common_types.json`, `functions.json`) moved with it.
+
+### Changed
+- **The catalog is consumed, not owned (ADR-0050).** Every load path — `retrieval/catalog.js`, `retrieval/component-catalog.js`, `retrieval/intent/prompt-analyzer`, `compose/strategies/monolithic/_shared.js`, `compose/transpiler/transpiler-maps.js`, `validate/catalog-validator.js` — reads the contract from the protocol package over the existing one-way `gen-ui → a2ui` dep edge. gh#748's published-consumer guarantee is preserved unchanged in shape: a bare specifier (`@adia-ai/a2ui/catalog`) tried FIRST, then the sibling-relative fetch/fs fallbacks, which resolve identically in the repo, on the static deploy, and in a flat `node_modules` tree.
+- **Package directory moved `packages/gen-ui` → `packages/gen-ui/engine` (ADR-0049, gh#1244).** Directory move only — the npm name, exports, and API are unchanged.
+
 ## [0.8.37] — 2026-08-14
 
 ### Fixed

package/README.md

@@ -7,7 +7,7 @@ One-way dependency: `gen-ui → a2ui`. This package produces A2UI documents;
 `@adia-ai/a2ui` is the protocol runtime that renders them. Nothing here is
 required to *render* A2UI — only to *generate* it.
 
-Minted by [ADR-0048](../../docs/adr/adr-0048-a2ui-gen-ui-estate-split.md) by
+Minted by [ADR-0048](../../../docs/adr/adr-0048-a2ui-gen-ui-estate-split.md) by
 folding together four previously separate packages.
 
 ## What's inside
@@ -44,9 +44,15 @@ import { pick, registerEngine } from '@adia-ai/gen-ui/compose/strategies/registr
 import { classifyIntent }       from '@adia-ai/gen-ui/retrieval/domain-router';
 import { getChunk }             from '@adia-ai/gen-ui/corpus/chunk-library';
 import { validateMessages }     from '@adia-ai/gen-ui/validate/catalog';
-import catalog                  from '@adia-ai/gen-ui/corpus' with { type: 'json' };
+import catalog                  from '@adia-ai/a2ui/catalog' with { type: 'json' };
 ```
 
+The catalog import is **not** a typo: since ADR-0050 the catalog is the
+protocol-side contract and ships from `@adia-ai/a2ui/catalog` (this package
+consumes it over the one-way `gen-ui → a2ui` edge). `@adia-ai/gen-ui/corpus/*`
+still serves the corpus fuel — chunks, manifest, embeddings, chunk-library —
+and the bare `@adia-ai/gen-ui/corpus` root export was removed with the move.
+
 ## Migrating from the old package names
 
 | Old | New |
@@ -64,7 +70,7 @@ The deprecated `@adia-ai/a2ui-compose/engine` and `/engines/*` aliases are
 
 Protocol-side validation (`validateSchema`) did **not** move here — it stays
 in the protocol package. The full map lives in
-[`.claude/docs/MIGRATION GUIDE.md`](../../.claude/docs/MIGRATION%20GUIDE.md).
+[`.claude/docs/MIGRATION GUIDE.md`](../../../.claude/docs/MIGRATION%20GUIDE.md).
 
 ## Maintaining
 

package/compose/CHANGELOG.md

@@ -1203,7 +1203,7 @@ Source: `packages/a2ui/compose/strategies/monolithic/_shared.js` (+91, -2 lines,
 
 - **`strategies/monolithic/generate-pro.js` — STRUCTURAL REFERENCE prose enriched.** Prior copy: "a real production block from the codebase matched this intent." New copy: "this chunk was retrieved from the AdiaUI training corpus (annotated production HTML, harvested from real app pages). It matched your intent on keyword/domain ranking." Threads chunk `metadata.domain`, `metadata.description`, `metadata.keywords` into the prompt when present. Reframes "do not copy the HTML" as "the chunk represents the SHAPE the user wants; instantiate it with their content" — more actionable framing.
 
-See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the v0.4.5 overhaul arc + apps/genui/CHANGELOG.md `[Unreleased]` for the per-§ rollup.
+See root [CHANGELOG.md `[Unreleased]`](../../../../CHANGELOG.md) for the v0.4.5 overhaul arc + apps/genui/CHANGELOG.md `[Unreleased]` for the per-§ rollup.
 ## [0.4.4] - 2026-05-12
 
 ### Changed
@@ -1219,7 +1219,7 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the v0.4.5 ove
 - **`compose/strategies/monolithic/generate-pro.js` + companion `_shared/fragment-expander.js` — fragment machinery removed (§37).** Fragments retired; 85 compositions inlined with previously-referenced fragment content. Expander deleted; its caller's try/catch in `generator-adapter.js` handles the absence gracefully.
 - **MCP server `mcp/server.js` (§37).** Removed `get_fragment` tool, simplified `zettel_stats`, updated imports + boot logs + engine description to reflect the post-fragment world.
 
-See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutting arc narrative + `.claude/docs/journal/2026/05/2026-05-12.md` §§ 37 / 38 / 41 / 47 for per-§ details.
+See root [CHANGELOG.md `[Unreleased]`](../../../../CHANGELOG.md) for the cross-cutting arc narrative + `.claude/docs/journal/2026/05/2026-05-12.md` §§ 37 / 38 / 41 / 47 for per-§ details.
 ## [0.4.3] - 2026-05-11
 
 ### Fixed
@@ -1228,46 +1228,46 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutt
 
 ### Lockstep
 
-9-package coordinated PATCH cut to v0.4.3 (per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Source change scoped to `core/generator.js` + `strategies/zettel/state-cache.js`. Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale + thousands grouping + hold-to-repeat). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md) for the cut narrative.
+9-package coordinated PATCH cut to v0.4.3 (per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Source change scoped to `core/generator.js` + `strategies/zettel/state-cache.js`. Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale + thousands grouping + hold-to-repeat). 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
 
 ### Ride-along (no source changes)
 
 Lockstep PATCH cut alongside `@adia-ai/web-modules@0.4.1` (simple cluster) + `@adia-ai/a2ui-validator@0.4.1` (Phase 3 foundation) + `@adia-ai/a2ui-corpus@0.4.1` (fragment metrics reconciliation). Source byte-identical to v0.4.0.
 
-Internal `@adia-ai/*` dep ranges bumped from `^0.4.0` to `^0.4.1`. See root [CHANGELOG.md `## [0.4.1]`](../../../CHANGELOG.md) for the cut narrative.
+Internal `@adia-ai/*` dep ranges bumped from `^0.4.0` to `^0.4.1`. See root [CHANGELOG.md `## [0.4.1]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.0] - 2026-05-10
 
 ### Ride-along (no source changes)
 
 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). Internal `@adia-ai/*` ranges stay at `^0.3.0` (patch-cut asymmetry — caret floats `0.3.x`).
+**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). Internal `@adia-ai/*` ranges stay at `^0.3.0` (patch-cut asymmetry — caret floats `0.3.x`).
 
 ### Added
 
@@ -1312,7 +1312,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`.
 
 ### Added
@@ -1337,7 +1337,7 @@ Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
 - `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).
 
@@ -1347,7 +1347,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 + LLM subpath dropped.** 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 + LLM subpath dropped.** 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`.
 
 This is a **minor cut on top of v0.2.5 with one BREAKING change**: the `./llm` subpath export is removed. The LLM adapters that previously shipped under `@adia-ai/a2ui-compose/llm` now ship as their own package, `@adia-ai/llm` (9th lockstep member, first publish in this cut).
 
@@ -1392,7 +1392,7 @@ This is a **minor cut on top of v0.2.5 with one BREAKING change**: the `./llm` s
 Plus rewrite imports as shown above. The change is mechanical.
 ## [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-compose` rides along at version bump only — no source change.
 
@@ -1402,7 +1402,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.
 
@@ -1422,7 +1422,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
@@ -1437,7 +1437,7 @@ Patch cut — no breaking changes.
 `@adia-ai/a2ui-compose` source is byte-identical to `0.2.2`. The cut bumps version + the internal dep range entries only.
 ## [0.2.2] - 2026-05-02
 
-**Lockstep cut + reasoning-panel emission fixes.** 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 + reasoning-panel emission fixes.** 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
 
@@ -1460,7 +1460,7 @@ Companion fix in `@adia-ai/a2ui-retrieval` Unreleased (web-research.js EXPLICIT/
 ---
 ## [0.2.1] - 2026-05-02
 
-**Lockstep cut + scope-drift gate at composer time + skeleton harvest + Tier-1 block filter + high-resolution session ticket trace.** 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 + scope-drift gate at composer time + skeleton harvest + Tier-1 block filter + high-resolution session ticket trace.** 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
 
@@ -1500,7 +1500,7 @@ The synthesizer now captures a `retrievalTrace` per attempt: Tier-1 hits with sc
 
 **Lockstep cut + boundary cleanup.** 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).
+[`.claude/docs/specs/package-architecture.md` § 15 (Versioning Policy)](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 This release also lands the `engine/` ↔ `engines/` collision fix from
 T3 of the
 `.claude/docs/plans/packages-architecture-fixes-2026-05-02.md`
@@ -1522,14 +1522,14 @@ plan.
   internal imports were also rewritten by the same sweep (no behavior
   change). All internal imports updated in one sweep.
 - **`constitution.md` moved out of the package source** to
-  [`.claude/docs/specs/compose-constitution.md`](../../../.claude/docs/specs/compose-constitution.md)
+  [`.claude/docs/specs/compose-constitution.md`](../../../../.claude/docs/specs/compose-constitution.md)
   so it doesn't ship in the published tarball. Pointer added in
   README.
 - **`package.json` `exports` map updated** with new keys (`./core`,
   `./strategies/registry`, `./strategies/zettel`); old keys
   (`./engine`, `./engines/registry`, `./engines/zettel`) retained as
   aliases for one release cycle and removed in the next major.
-- Spec [`.claude/docs/specs/package-architecture.md`](../../../.claude/docs/specs/package-architecture.md)
+- Spec [`.claude/docs/specs/package-architecture.md`](../../../../.claude/docs/specs/package-architecture.md)
   bumped 0.5.0 → 0.6.0 with the directory tree updated to reflect the
   new layout; new § 15 documents the lockstep versioning policy.
 
@@ -1557,7 +1557,7 @@ zettel engine that turn `compose_from_chunks` from single-shot into a
 multi-turn surface, plus a first-class telemetry surface that auto-fires
 issue tickets on engine failure paths.
 
-Spec: [`.claude/docs/specs/genui-multiturn-architecture.md`](../../../.claude/docs/specs/genui-multiturn-architecture.md) (Active v0.1.0).
+Spec: [`.claude/docs/specs/genui-multiturn-architecture.md`](../../../../.claude/docs/specs/genui-multiturn-architecture.md) (Active v0.1.0).
 Plan: `.claude/docs/plans/genui-multiturn-rollout-2026-04-28.md` (Phase A scoped).
 ADR: `0008-multiturn-genui-architecture.md`.
 

package/compose/README.md

@@ -1,13 +1,13 @@
 # @adia-ai/a2ui-compose
 
 Framework-agnostic UI generation engine. Constitution doc:
-[`.claude/docs/specs/compose-constitution.md`](../../../.claude/docs/specs/compose-constitution.md).
+[`.claude/docs/specs/compose-constitution.md`](../../../../.claude/docs/specs/compose-constitution.md).
 Takes a natural-language intent +
 an A2UI component catalog and produces a tree of A2UI protocol messages
 ready for a renderer.
 
 > This package is pipeline runtime only. UI components live in
-> [`@adia-ai/web-components`](../../web-components); the A2UI runtime (renderer,
+> [`@adia-ai/web-components`](../../../web-components); the A2UI runtime (renderer,
 > registry, streams, wiring) in [`@adia-ai/a2ui-runtime`](../../a2ui);
 > the pattern corpus in [`@adia-ai/a2ui-corpus`](../corpus);
 > the MCP server in [`@adia-ai/mcp`](../../mcp) (its `gen-ui` surface).
@@ -127,7 +127,7 @@ registerEngine('my-engine', async (ctx) => {
 `free-form` → `monolithic-instant` → `monolithic-pro`, cheapest first, each
 step accepted or rejected by the shared escalation rule
 (`strategies/escalation.js`) and the last step terminal. It is declared as an
-[`@adia-ai/agent`](../../agent/README.md) workflow in
+[`@adia-ai/agent`](../../../llm/agent/README.md) workflow in
 `strategies/cascade.js`, so the ladder is data — `ENGINE_LADDER` — and the
 result carries `escalations` (`{from, to, trigger}`) as its trace.
 

package/compose/evals/harness.mjs

@@ -29,7 +29,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 export async function loadHeldOut() {
   // held-out.jsonl lives in the sibling @adia-ai/gen-ui/corpus package.
   // Callers can still pass `intents` explicitly; this fallback is the default.
-  // Path from here: packages/gen-ui/compose/evals/ → ../.. → packages/gen-ui/
+  // Path from here: packages/gen-ui/engine/compose/evals/ → ../.. → packages/gen-ui/engine/
   // → corpus/evals/held-out.jsonl.
   const evalsPath = join(__dirname, '..', '..', 'corpus', 'evals', 'held-out.jsonl');
   const raw = await readFile(evalsPath, 'utf8');

package/compose/strategies/_shared/chunk-loader.js

@@ -3,12 +3,12 @@
  *
  * Mirrors the dual-environment loading approach historically used by
  * pattern-library.js (retired §64) so the gen-UI training chunks at
- * packages/gen-ui/corpus/chunks/*.json are reachable from BOTH server-side
+ * packages/gen-ui/engine/corpus/chunks/*.json are reachable from BOTH server-side
  * engines (monolithic-pro via /api/generate's Node process) AND
  * browser-side engines (monolithic-pro called directly from
  * gen-ui playground's IIFE).
  *
- * The existing packages/gen-ui/corpus/scripts/chunk-library.js is Node-only
+ * The existing packages/gen-ui/engine/corpus/scripts/chunk-library.js is Node-only
  * (uses node:fs / readdirSync). This module exists so monolithic-pro can
  * search + fetch chunks WITHOUT pulling node:fs into the browser bundle.
  *

package/compose/strategies/monolithic/_shared.js

@@ -102,9 +102,11 @@ function adaptV09Component(a2uiData) {
 
 // Component prop catalog — loaded lazily for prompt injection.
 //
-// Since §65 (v0.4.7), reads from the canonical v0.9 catalog at
-// `corpus/catalog-a2ui_0_9.json` (assembled from yamls by `npm run
-// components`). Previously read the hand-maintained
+// Since §65 (v0.4.7), reads from the canonical v0.9 catalog (assembled from
+// yamls by `npm run components`); since ADR-0050 that catalog is protocol-side
+// at `@adia-ai/a2ui/catalog` — `../../../../a2ui/catalog/` from here, which is
+// the sibling package dir in the repo and in a flat node_modules install
+// alike. Previously read the hand-maintained
 // `corpus/patterns/_components.json` which was retired in §65.
 // Aliases come from `x-adiaui.synonyms.tags` per the v0.9 sidecar shape;
 // migrated in §65 step 1 — 17 yamls populated with synonyms.tags from
@@ -119,11 +121,22 @@ async function getComponentCatalog() {
       const fs = await import(/* @vite-ignore */ 'node:fs/promises');
       const path = await import(/* @vite-ignore */ 'node:path');
       const url = await import(/* @vite-ignore */ 'node:url');
+      // ADR-0050: resolve the catalog by package specifier first — the only
+      // path that holds in a published tarball, where a relative walk would
+      // escape this package's root — and fall back to the sibling-relative
+      // path for the repo / static deploy.
+      const { createRequire } = await import(/* @vite-ignore */ 'node:module');
       const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
-      const raw = await fs.readFile(path.join(__dirname, '../../../corpus/catalog-a2ui_0_9.json'), 'utf8');
+      let catalogPath;
+      try {
+        catalogPath = createRequire(import.meta.url).resolve('@adia-ai/a2ui/catalog');
+      } catch {
+        catalogPath = path.join(__dirname, '../../../../a2ui/catalog/catalog-a2ui_0_9.json');
+      }
+      const raw = await fs.readFile(catalogPath, 'utf8');
       catalogJson = JSON.parse(raw);
     } else {
-      const resp = await fetch(new URL('../../../corpus/catalog-a2ui_0_9.json', import.meta.url));
+      const resp = await fetch(new URL('../../../../a2ui/catalog/catalog-a2ui_0_9.json', import.meta.url));
       catalogJson = resp.ok ? await resp.json() : {};
     }
     // Adapt the v0.9 catalog (JSON Schema with `components: {Name: {x-adiaui: {...}}}`)

package/compose/strategies/monolithic/generate-pro.js

@@ -99,7 +99,7 @@ export async function generatePro({ intent, executionId, storeId, llmAdapter, an
   const bestPattern = patterns[0];
 
   // ── Parallel chunk retrieval (training-corpus path) ──
-  // The chunks corpus at packages/gen-ui/corpus/chunks/*.json captures real
+  // The chunks corpus at packages/gen-ui/engine/corpus/chunks/*.json captures real
   // page-shape blocks harvested from working apps (auth/sign-in,
   // settings pages, dashboards, etc.). When a query strongly matches a
   // chunk, we inject the chunk's HTML as a STRUCTURAL REFERENCE into the

package/compose/strategies/zettel/composition-library.js

@@ -202,10 +202,10 @@ async function _loadAllBrowser() {
 //      so dev and prod resolve through one mental model.
 //   2. It is mount-point-independent: works whether dist is served at `/`,
 //      under a sub-path, or via the dist symlink layout
-//      (dist/node_modules/@adia-ai/gen-ui → packages/gen-ui),
+//      (dist/node_modules/@adia-ai/gen-ui → packages/gen-ui/engine),
 //      because `import.meta.url` always reflects the actually-served path.
 //      Verified 2026-06-10: `new URL('../../../corpus/chunks/_index.json',
-//      import.meta.url)` → `<root>/packages/gen-ui/corpus/chunks/_index.json`.
+//      import.meta.url)` → `<root>/packages/gen-ui/engine/corpus/chunks/_index.json`.
 const _CORPUS_CHUNKS_BASE =
   !IS_NODE && !HAS_VITE_GLOB
     ? new URL('../../../corpus/chunks/', import.meta.url)

package/compose/strategies/zettel/issue-reporter.js

@@ -22,7 +22,7 @@ import { dirname, resolve, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const REPO_ROOT = resolve(__dirname, '../../../../..');
+const REPO_ROOT = resolve(__dirname, '../../../../../..');
 const DEFAULT_STORAGE_ROOT = resolve(REPO_ROOT, 'qa/findings/issues');
 const TRACE_INLINE_THRESHOLD_BYTES = 200 * 1024;
 

package/compose/transpiler/transpiler-maps.js

@@ -9,7 +9,7 @@
  *
  * §163 (v0.5.4) — Prop-fidelity fix: extractProps() now runs a
  * catalog-driven generic pass AFTER the legacy per-type blocks. The
- * catalog (`@adia-ai/gen-ui/corpus`'s v0.9 sidecars) is the single source
+ * catalog (`@adia-ai/a2ui/catalog`'s v0.9 catalog) is the single source
  * of truth for which attributes are first-class props per component
  * type. Pre-§163, the per-type blocks hardcoded an allowlist that
  * omitted `label`, `icon`, literal `variant=`, and similar — see
@@ -19,7 +19,7 @@
  * picks it up automatically without manual sync.
  */
 
-import catalogData from '../../corpus/catalog-a2ui_0_9.json' with { type: 'json' };
+import catalogData from '@adia-ai/a2ui/catalog' with { type: 'json' };
 
 import { registry } from '@adia-ai/a2ui';
 

package/compose/transpiler/transpiler.js

@@ -374,7 +374,7 @@ function emitUnmappedPlaceholder(el, id, tag, props, context) {
     // ("headline + body"); `text` is the single-line alternative, not a
     // companion to `title`.
     title: `Unmapped component: <${tag}>`,
-    description: `No entry in the A2UI runtime registry (packages/a2ui/registry.js), so this element's own props and behaviour were not converted. Register the tag, or remove it from the source.`,
+    description: `No entry in the A2UI runtime registry (packages/gen-ui/a2ui/registry.js), so this element's own props and behaviour were not converted. Register the tag, or remove it from the source.`,
   });
 
   return id;

package/corpus/CHANGELOG.md

@@ -1179,7 +1179,7 @@ All `corpus/chunks/*.json` files have updated `captured_at` timestamps from the
 
 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
 
 ### Changed — corpus simplification arc (§36-§51, 2026-05-12)
@@ -1229,7 +1229,7 @@ The harvester is repo-tooling (`scripts/build/`), not a corpus package member, b
 - **§42 nested-expand-then-transpile pass** — after collection, recursively expands `<!-- nested: <name> -->` placeholders in annotated chunks, then transpiles the expanded HTML to A2UI templates via `transpileHTML(html, { mode: 'instant' })`.
 - **§45 source-aware tier-1 expansion fix** — replaces §42's "first wins" canonical-html rule with directory-aware selection. **Bug**: `auth-card-content` has 24 instances; the 404 page sorted alphabetically first, so EVERY auth chunk silently inlined 404 page content from §41 landing through §45 discovery (smoke tests only checked retrieval strategy, not template content). **Fix**: Tier 1 exact directory match → Tier 2 deepest common directory prefix → Tier 3 alphabetical. Without it, `apps/user-flow/app/auth/sign-in/` shares depth with `apps/user-flow/app/auth/sign-in/mfa/` and tie-break would pick wrong sibling.
 
-See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutting arc narrative + `.claude/docs/journal/2026/05/2026-05-12.md` §§ 36-51 for per-§ details.
+See root [CHANGELOG.md `[Unreleased]`](../../../../CHANGELOG.md) for the cross-cutting arc narrative + `.claude/docs/journal/2026/05/2026-05-12.md` §§ 36-51 for per-§ details.
 ## [0.4.3] - 2026-05-11
 
 ### Changed
@@ -1240,7 +1240,7 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutt
 
 ### Lockstep
 
-9-package coordinated PATCH cut to v0.4.3. Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry). Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale rewrite) and `@adia-ai/a2ui-compose` + `@adia-ai/a2ui-retrieval` v0.4.3 (process.env browser-compat fix). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md).
+9-package coordinated PATCH cut to v0.4.3. Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry). Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale rewrite) and `@adia-ai/a2ui-compose` + `@adia-ai/a2ui-retrieval` v0.4.3 (process.env browser-compat fix). See root [CHANGELOG.md `## [0.4.3]`](../../../../CHANGELOG.md).
 ## [0.4.2] - 2026-05-11
 
 ### Changed
@@ -1255,7 +1255,7 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutt
 
 ### Lockstep
 
-9-package coordinated PATCH cut to v0.4.2 (per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Rides alongside `@adia-ai/web-components@0.4.2` (input-ui type=number rewrite) and `@adia-ai/web-modules@0.4.2` (editor-sidebar width mirror). See root [CHANGELOG.md `## [0.4.2]`](../../../CHANGELOG.md) for the cut narrative.
+9-package coordinated PATCH cut to v0.4.2 (per [`.claude/docs/specs/package-architecture.md` § 15](../../../../.claude/docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Rides alongside `@adia-ai/web-components@0.4.2` (input-ui type=number rewrite) and `@adia-ai/web-modules@0.4.2` (editor-sidebar width mirror). See root [CHANGELOG.md `## [0.4.2]`](../../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.1] - 2026-05-10
 
 ### Changed
@@ -1273,7 +1273,7 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutt
 
 Lockstep MINOR cut alongside `@adia-ai/web-modules@0.4.0` (ADR-0024 legacy deprecation). Catalog regenerated; chunks/fragments/compositions/patterns 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
 
 ### Changed
@@ -1326,7 +1326,7 @@ The catalog is consumed by `@adia-ai/a2ui-retrieval` for protocol-vocabulary com
 Corpus chunks, fragments, compositions, and patterns are byte-identical to v0.3.3. The only change is the regenerated catalog manifest.
 ## [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). Internal `@adia-ai/*` ranges stay at `^0.3.0` (patch-cut asymmetry — caret floats `0.3.x`).
+**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). Internal `@adia-ai/*` ranges stay at `^0.3.0` (patch-cut asymmetry — caret floats `0.3.x`).
 
 ### Added
 
@@ -1361,7 +1361,7 @@ Corpus chunks, fragments, compositions, and patterns are byte-identical to v0.3.
 ## [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`.
 
 ### Added
@@ -1388,7 +1388,7 @@ Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
 - `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).
 
@@ -1398,7 +1398,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`. Both are BREAKING for npm consumers (acceptable under pre-1.0 semver).
 
@@ -1413,7 +1413,7 @@ This package itself ships **no source changes** in v0.3.0. The cut bumps version
 `a2ui-corpus` source is byte-identical to `0.2.5`. The cut bumps version only — corpus has no `@adia-ai/*` dependencies so no dep-range updates either.
 ## [0.2.5] - 2026-05-04
 
-**Lockstep cut + catalog regen for `<fields-ui>` primitive.** 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). Patch cut — **no BREAKING changes**.
+**Lockstep cut + catalog regen for `<fields-ui>` primitive.** 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). Patch cut — **no BREAKING changes**.
 
 ### Changed
 
@@ -1422,7 +1422,7 @@ This package itself ships **no source changes** in v0.3.0. The cut bumps version
 - Per-element `fields/fields.a2ui.json` written by `scripts/build/components.mjs`.
 ## [0.2.4] - 2026-05-04
 
-**Lockstep cut + catalog regen for `<demo-toggle-ui>` primitive.** 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). Patch cut — no breaking changes.
+**Lockstep cut + catalog regen for `<demo-toggle-ui>` primitive.** 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). Patch cut — no breaking changes.
 
 ### Changed
 
@@ -1444,7 +1444,7 @@ the generated `_catalog.json` consumed by
 
 **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
@@ -1456,7 +1456,7 @@ Patch cut — no breaking changes.
 `@adia-ai/a2ui-corpus` 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
 
@@ -1469,7 +1469,7 @@ Patch cut — no breaking changes.
 ---
 ## [0.2.1] - 2026-05-02
 
-**Lockstep cut + chunk-corpus reorganization mega-arc + trait registry regenerated from web-components SoT.** 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 + chunk-corpus reorganization mega-arc + trait registry regenerated from web-components SoT.** 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
 
@@ -1535,7 +1535,7 @@ Per-finding triage in `.claude/docs/reports/playground-examples-review-2026-05-0
 
 **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).
 
 This release also formalizes corpus's role as **the catalog's home** —
 spec § 3 first-principle 3 was rewritten in v0.6.0 of the spec to
@@ -1783,11 +1783,11 @@ existing pattern/fragment/composition surface unchanged.
 
 ### Convention reference
 
-- Spec: [`.claude/docs/specs/genui-chunk-marker.md`](../../../.claude/docs/specs/genui-chunk-marker.md)
+- Spec: [`.claude/docs/specs/genui-chunk-marker.md`](../../../../.claude/docs/specs/genui-chunk-marker.md)
   (Draft v0.1.0) — three attributes (`data-chunk`, `data-chunk-kind`,
   `data-chunk-slot`); naming conventions per cluster; visual marker
   rules; harvester contract.
-- Inventory: [`.claude/docs/specs/genui-chunk-inventory-001.md`](../../../.claude/docs/specs/genui-chunk-inventory-001.md)
+- Inventory: [`.claude/docs/specs/genui-chunk-inventory-001.md`](../../../../.claude/docs/specs/genui-chunk-inventory-001.md)
   — full list with intent labels + review status.
 ## [0.0.2] - 2026-04-27
 

package/corpus/README.md

@@ -6,7 +6,7 @@ fixtures. Pure data plus the scripts that maintain it. No runtime.
 
 > The pipeline reads this package; this package never reads the pipeline.
 > See [`@adia-ai/a2ui-compose`](../compose) for engine code,
-> [`@adia-ai/web-components`](../../web-components) for UI atoms,
+> [`@adia-ai/web-components`](../../../web-components) for UI atoms,
 > [`@adia-ai/a2ui-runtime`](../../a2ui) for the A2UI runtime (renderer,
 > registry, streams, wiring),
 > [`@adia-ai/mcp`](../../mcp) for the MCP server (its `gen-ui` surface).
@@ -155,7 +155,7 @@ Currently pinned defaults:
 | openai | `text-embedding-3-small` | 1536 | `OPENAI_API_KEY` |
 | voyage | `voyage-3-lite` | 1024 | `VOYAGE_API_KEY` |
 
-`detectProvider()` (in `packages/a2ui/retrieval/embedding/embedding-provider.js`)
+`detectProvider()` (in `packages/gen-ui/a2ui/retrieval/embedding/embedding-provider.js`)
 prefers Voyage when both keys are present (denser vectors, lower cost).
 The `build:embeddings*` scripts record the chosen provider/model into the
 `.json` header, so subsequent reads always re-bind to the same model.