@adia-ai/gen-ui 0.8.37

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog — @adia-ai/gen-ui
+
+## [0.8.37] — 2026-08-14
+
+### Fixed
+- **`retrieval/wiring-catalog.ts` was missing `StateMachineController` (ADR-0048 P4, gh#1192).** The runtime has resolved it since it was registered, but this hand-written knowledge base never gained a row — so generation was told a controller it could legally emit did not exist, and `get_wiring_catalog` handed the same wrong list to every MCP client. Found by diffing the list against `@adia-ai/a2ui`'s live `wiringRegistry` (6 controllers vs the 5 listed) while building the protocol MCP's registry-derived form. The entry mirrors the controller's `static schema` — `commands` and `config` verbatim, `bind` keyed on its `current` / `history` state keys. Additive: one more element in `controllers[]`, no field or shape changed. The two lists now agree 6/6.
+
+  Root cause is structural, not a typo: a hand-maintained mirror of a runtime registry has nothing gating it. The protocol MCP's `get_wiring_catalog` reads `wiringRegistry` live and cannot drift this way; this module keeps the authoring fields (event payloads, refresh strategies, value sources, associations, per-controller config/commands/bind) that are not registry-derivable, so it stays hand-maintained — check it against `wiringRegistry.controllers` when a controller is registered.
+
+### Added
+- **New package — the generation half of the A2UI estate split (ADR-0048, gh#1192).** `@adia-ai/gen-ui` folds four previously separate packages into one:
+  - `compose/` ← `@adia-ai/a2ui-compose`
+  - `retrieval/` ← `@adia-ai/a2ui-retrieval`
+  - `corpus/` ← `@adia-ai/a2ui-corpus`
+  - `validate/` ← the catalog-aware + LLM-judge halves of `@adia-ai/a2ui-validator`
+
+  Moved with `git mv`, so per-file history follows. Subpath exports are documented in `README.md`; the old→new import map lives in `.claude/docs/MIGRATION GUIDE.md`.
+
+- **The retrieval↔compose import cycle is gone by construction.** `retrieval/context-assembler.js` and `retrieval/intent/clarity.ts` reached backwards into compose's zettel `composition-library`, while seven compose files reached forwards into retrieval. Both directions are now relative intra-package imports — there is no longer a package boundary to cycle across.
+
+### Changed
+- **`validate/catalog-validator.js` resolves the corpus by self-reference.** The gh#748 published-consumer guarantee (a bare specifier tried FIRST, so a plain `npm i` consumer gets a working catalog with no repo layout) is preserved — the specifier is now `@adia-ai/gen-ui/corpus`, this package's own subpath export, instead of a cross-package dependency. The module-relative fallback chain is unchanged and still resolves, because `validate/` sits at the same depth `validator/` did.
+
+### Notes
+- This package is not yet published; it lands with the `0.8.37` migration cut (ADR-0048 P7). Until then the old package directories carry workspace-only, `private: true` re-export stubs so in-repo consumers keep resolving.
+- Protocol-side validation (`validateSchema`) deliberately did **not** move here. It stays in the protocol package so an embedding host can validate A2UI without pulling ajv, an LLM client, or the training corpus.

package/README.md

@@ -0,0 +1,77 @@
+# @adia-ai/gen-ui
+
+The AdiaUI **generation** system: it turns a natural-language intent into
+[A2UI](https://github.com/adiahealth/gen-ui-kit) protocol messages.
+
+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
+folding together four previously separate packages.
+
+## What's inside
+
+| Dir | Was | Does |
+|---|---|---|
+| `compose/` | `@adia-ai/a2ui-compose` | Strategy engines (monolithic · zettel · chunk-zettel · free-form), the escalation cascade, the HTML→A2UI transpiler, eval harness |
+| `retrieval/` | `@adia-ai/a2ui-retrieval` | Intent classification, domain routing, embeddings, anti-patterns, context assembly, the feedback loop |
+| `corpus/` | `@adia-ai/a2ui-corpus` | The v0.9 component catalog, harvested training chunks, chunk embeddings, eval fixtures |
+| `validate/` | `@adia-ai/a2ui-validator` (catalog + semantic halves) | Catalog-aware structural validation and the LLM semantic judge |
+
+Folding `retrieval` and `compose` into one package is what dissolved the
+long-standing import cycle between them — both sides are now plain relative
+imports.
+
+## Install
+
+```bash
+npm i @adia-ai/gen-ui
+```
+
+## Use
+
+```js
+import { generateUI } from '@adia-ai/gen-ui';
+
+const { messages } = await generateUI('a login form with email and password');
+```
+
+Subpaths address each half directly:
+
+```js
+import { pick, registerEngine } from '@adia-ai/gen-ui/compose/strategies/registry';
+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' };
+```
+
+## Migrating from the old package names
+
+| Old | New |
+|---|---|
+| `@adia-ai/a2ui-compose` | `@adia-ai/gen-ui` |
+| `@adia-ai/a2ui-compose/<sub>` | `@adia-ai/gen-ui/compose/<sub>` |
+| `@adia-ai/a2ui-retrieval` (`/<sub>`) | `@adia-ai/gen-ui/retrieval` (`/<sub>`) |
+| `@adia-ai/a2ui-corpus` (`/<sub>`) | `@adia-ai/gen-ui/corpus` (`/<sub>`) |
+| `@adia-ai/a2ui-validator/catalog` | `@adia-ai/gen-ui/validate/catalog` |
+| `@adia-ai/a2ui-validator/semantic` | `@adia-ai/gen-ui/validate/semantic` |
+
+The deprecated `@adia-ai/a2ui-compose/engine` and `/engines/*` aliases are
+**not** carried over — they were already deprecated one cycle. Use
+`compose/core` and `compose/strategies/*`.
+
+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).
+
+## Maintaining
+
+The corpus chunks are **build outputs** — harvested from `data-chunk`-tagged
+demo HTML via `npm run harvest:chunks`. Never hand-edit
+`corpus/chunks/*.json`. Likewise the catalog artifact is generated by
+`scripts/build/components.mjs`.
+
+Eval floors are preserve-not-regress and gate every calibration change; see
+the `a2ui-maintenance` skill for the pipeline contract and the floor numbers.