@adia-ai/a2ui-corpus 0.5.4 → 0.5.6

package/CHANGELOG.md

@@ -14,11 +14,40 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 > details. References to "8 packages" in older entries are factually
 > correct as of the date they were written and are preserved per
 > Keep-A-Changelog convention (don't rewrite history).
-
 ## [Unreleased]
 
 _No pending changes._
+## [0.5.6] - 2026-05-14
+
+_Lockstep ride-along (no source change)._
+## [0.5.5] - 2026-05-14
+
+### Added — §176 (v0.5.5) — six new sub-component catalog entries
+
+Six sibling yamls authored under the v0.5.4 §172 scanner pattern (parent-folder co-located):
+
+- `list/list-item.yaml` (3 props: icon, text, description)
+- `avatar/avatar-group.yaml` (2 props: max, size)
+- `accordion/accordion-item.yaml` (2 props: text, open)
+- `timeline/timeline-item.yaml` (8 props: text, description, time, duration, icon, variant, status, spinner)
+- `action-list/action-item.yaml` (5 props: icon, text, value, variant, disabled)
+- `tabs/tab.yaml` (4 props: text, value, icon, disabled)
+
+These describe co-located sub-component classes that previously existed as registered custom elements (e.g. `UIListItem` from `list/class.js`) without their own catalog entry — surfaced as the §175 baseline-orphan class. Now LLM-driven generation has access to per-prop signatures for sub-components.
+
+Catalog: **125 → 131 components** (+6).
 
+### Changed — corpus re-harvested
+
+230 chunks re-harvested against the updated transpiler. **9 chunks improved** with restored Tab/ActionItem/AvatarGroup/ChatInput props that the transpiler previously dropped (same architectural class as v0.5.4 §163/§164 catalog→transpiler drift fix — applied at finer grain on newly-authored sub-components). `chunk-embeddings.json` rebuilt (230 × 1536-dim, 6,632 KB).
+
+### Added — §184 (v0.5.5, peer FEEDBACK-08) — tree-item catalog entry
+
+Seventh sibling yaml: `packages/web-components/components/tree/tree-item.yaml`. `UITreeItem` is no longer an orphan class; has its own catalog entry, `.d.ts`, and `.a2ui.json` sidecar.
+
+Catalog after §184: **132 components**.
+
+Commits `443365913` + `30025e51e` (peer). See root CHANGELOG and journal §176/§184 for full context.
 ## [0.5.4] - 2026-05-14
 
 ### Changed — §164 re-harvest 230 chunks against §163-fixed transpiler; +2,920 LOC restored prop fidelity (v0.5.4)
@@ -78,7 +107,6 @@ authored without v0.9-aware harvester contract, OR a new prop added
 to the v0.9 catalog that doesn't flow through to existing chunks.
 
 ### Changed — `version`: `0.5.3` → `0.5.4`.
-
 ## [0.5.3] - 2026-05-14
 
 ### Changed — `catalog-a2ui_0_9.json` regen for `<table-ui>` `row-collapse` event declaration (§162 ride-along, v0.5.3)
@@ -113,7 +141,6 @@ Corpus regen via `npm run harvest:chunks`: 222 → 230 chunks (+8); chunk index
 Expected impact: Haiku free-form coverage on the 100-intent held-out set lifts from 91% (post-v0.5.2 §125+§126) → ~98-99% (matching Opus's §127 ceiling). Empirical verification in v0.5.3 §145 rebaseline check (paired re-eval).
 
 Per the §127 verdict report (`docs/reports/free-form-haiku-vs-opus-2026-05-13.md`) — closing the coverage gap via chunk authoring is the right lever; model swap to Opus (5× cost) was rejected by the §127 decision rule. §143 ships the rejected-Opus's path-forward.
-
 ## [0.5.2] - 2026-05-13
 
 ### Changed — Catalog-text structural sweep on 5 under-substituted chunks (§125, v0.5.2)
@@ -134,7 +161,6 @@ Re-harvest via `npm run harvest:chunks` regenerated the 5 chunk JSONs to reflect
 Expected impact (verified post-§126): F1 lift 62 → ~65-68 from improved component-type coverage on the 5 intents (each lifts from ~67% to 100%). Substitution-ratio may also lift as the new structural primitives (badge-ui, button-ui) carry substitutable text the LLM can tailor.
 
 **Pivot note**: the v0.5.2 plan §125 documented "generic-placeholder text refinement" (Fix A) and "intent-shape-faithful chunks" (Fix B). The actual scorer logic (per `test-evals.mjs computeF1()`) is component-type set match — `tp / required.length` of the `expected_components` array. Text content doesn't enter F1 calculation. The corrected §125 approach is **structural refinement to match the expected component set**, retaining the chunk's design quality where the higher-level primitive (`<stat-ui>`) already carries the data shape.
-
 ## [0.5.1] - 2026-05-13
 
 ### Added — Mode-C corpus promotion (§112 + §113, v0.5.1)
@@ -146,7 +172,6 @@ The §93/§94/§104 v0.5.0 regrowth handled the structural / common shapes; §11
 ### Coverage at v0.5.1 cut
 
 Pairs with `@adia-ai/a2ui-compose@0.5.1`'s §106 INTENT-PARAPHRASE + §108/§109 picker work. Combined lift drives free-form coverage from v0.5.0's 92% to ~96-97% on the 100-intent held-out set. The §115 free-form-eval regression trip-wire (in `@adia-ai/web-components` repo-level scripts, NOT in this package) now hard-floors at `cov≥96%, avg≥85, F1≥0.60`.
-
 ## [0.5.0] - 2026-05-13
 
 ### Added — v0.5.0 corpus regrowth (§93 + §94 + §104, free-form coverage 21% → 92%)
@@ -168,17 +193,14 @@ For consumers building on the corpus directly (custom retrieval / `composition-l
 ### AGENTS.md regression threshold rebaseline
 
 §97 added a `free-form` row to `## Regression thresholds`: `cov≥80%, avg≥85, F1≥0.45`. Reflects the post-§104 honest floor; `eval:diff --engine free-form` exits 0 against this. Expected to climb further as v0.5.1+ corpus regrowth lands.
-
 ## [0.4.9] - 2026-05-13
 
 _No pending changes._
-
 ## [0.4.8] - 2026-05-12
 
 ### Changed — `catalog-a2ui_0_9.json` regen (v0.4.8 ride-along)
 
 `catalog-a2ui_0_9.json` regenerated to pick up v0.4.8 source-side additions across `packages/web-components/` + `packages/web-modules/`: §80 event-type declarations (38 non-form primitives now have `x-adiaui.events` populated for codegen consumption) + the new `composes:` field on web-module YAMLs (ADR-0027 wiring; lifted to `components[name].x-adiaui.composes` on the canonical catalog) + §88 free-form composition mode's component additions. Pure regen — no schema changes; corpus consumers get the new fields automatically.
-
 ## [0.4.7] - 2026-05-12
 
 ### Removed — `patterns/` + `compositions/` retired from disk + tarball (§72, the §65 carry-over from v0.4.6)
@@ -197,7 +219,6 @@ Hand-authored `corpus/patterns/<domain>/*.{json,yaml}` (~225 files) and `corpus/
 ### Changed — `README.md`, `data-flow.md`, `package.json` description
 
 `README.md` — Exports section rewritten to show the catalog-with-aliases pattern; line referencing `data-flow.md`'s "chunks → fragments → compositions → feedback" simplified to "chunks → feedback" reflecting the retired stages. `data-flow.md` — full rewrite describing the harvester-driven flow (no more extract.js → ingest.js). `package.json` description — "patterns, compositions, chunks, eval fixtures…" → "canonical v0.9 catalog + chunks + eval fixtures…".
-
 ## [0.4.6] - 2026-05-12
 
 ### Removed — `corpus/scripts/` retirement (§64 step 3, v0.4.6)
@@ -264,7 +285,6 @@ Source: commit `7b62cb19` (196 files; mostly `corpus/chunks/*.json` re-harvest t
 ### Refreshed — corpus re-harvest (§63 ride-along; 190+ chunk `captured_at` timestamps)
 
 All `corpus/chunks/*.json` files have updated `captured_at` timestamps from the `npm run harvest:chunks` re-run after the `settings-page.contents.html` annotation. No content changes; pure metadata refresh.
-
 ## [0.4.5] - 2026-05-12
 
 ### Ride-along (no source changes)
@@ -272,7 +292,6 @@ 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.
-
 ## [0.4.4] - 2026-05-12
 
 ### Changed — corpus simplification arc (§36-§51, 2026-05-12)
@@ -323,7 +342,6 @@ The harvester is repo-tooling (`scripts/build/`), not a corpus package member, b
 - **§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 + [docs/journal/2026/05/2026-05-12.md](../../../docs/journal/2026/05/2026-05-12.md) §§ 36-51 for per-§ details.
-
 ## [0.4.3] - 2026-05-11
 
 ### Changed
@@ -335,7 +353,6 @@ 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).
-
 ## [0.4.2] - 2026-05-11
 
 ### Changed
@@ -351,7 +368,6 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutt
 ### Lockstep
 
 9-package coordinated PATCH cut to v0.4.2 (per [`docs/specs/package-architecture.md` § 15](../../../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
@@ -363,7 +379,6 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutt
 ### Added
 
 - `docs/reports/chunk-reconcile-triage-2026-05-10.md` — triage doc documenting that all current `audit:chunk-reconcile` findings (9 fingerprint collisions + 19 near-duplicates + 10 cross-source) are intentional outcomes of the onb/reg alignment work + foundational shared chunks.
-
 ## [0.4.0] - 2026-05-10
 
 ### Ride-along (no corpus changes)
@@ -371,7 +386,6 @@ 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.
-
 ## [0.3.6] - 2026-05-10
 
 ### Changed
@@ -389,7 +403,6 @@ The catalog is consumed by `@adia-ai/a2ui-retrieval` for protocol-vocabulary com
 ### No source changes
 
 Corpus chunks, fragments, compositions, and patterns are byte-identical to v0.3.5. The only change is the regenerated catalog manifest.
-
 ## [0.3.5] - 2026-05-07
 
 ### Changed
@@ -407,7 +420,6 @@ The catalog is consumed by `@adia-ai/a2ui-retrieval` for protocol-vocabulary com
 ### No source changes
 
 Corpus chunks, fragments, compositions, and patterns are byte-identical to v0.3.4. The only change is the regenerated catalog manifest.
-
 ## [0.3.4] - 2026-05-07
 
 ### Changed
@@ -424,7 +436,6 @@ The catalog is consumed by `@adia-ai/a2ui-retrieval` for protocol-vocabulary com
 ### No source changes
 
 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 [`docs/specs/package-architecture.md` § 15](../../../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`).
@@ -459,7 +470,6 @@ Corpus chunks, fragments, compositions, and patterns are byte-identical to v0.3.
   generated artifacts are `traits/_catalog.json` and per-component
   `<name>.a2ui.json` sidecars. (companion to AGENTS.md hard-rule #7
   correction; closes backlog #57)
-
 ## [0.3.2] - 2026-05-06
 
 **9-package lockstep patch cut to v0.3.2.** All lockstep members share
@@ -488,7 +498,6 @@ Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
 ### Changed
 
 - `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 [`docs/specs/package-architecture.md` § 15](../../../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).
@@ -499,7 +508,6 @@ This package itself ships **no source changes** in v0.3.1. The cut bumps version
 
 - `version`: `0.3.0` → `0.3.1`.
 - 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 [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges bump `^0.2.0` → `^0.3.0`.
@@ -515,7 +523,6 @@ This package itself ships **no source changes** in v0.3.0. The cut bumps version
 ### No source changes
 
 `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 [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — **no BREAKING changes**.
@@ -525,7 +532,6 @@ This package itself ships **no source changes** in v0.3.0. The cut bumps version
 - `version`: `0.2.4` → `0.2.5`.
 - `catalog-a2ui_0_9.json`: 1 new entry covering the new `<fields-ui>` primitive (component class `Fields`, tag `fields-ui`, props `[columns]` + `[inline]`, default slot for `<field-ui>` children + the `rows` span pattern). Catalog: 97 → 98 yamls.
 - 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 [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
@@ -546,7 +552,6 @@ the generated `_catalog.json` consumed by
 `@adia-ai/a2ui-retrieval`.
 
 ---
-
 ## [0.2.3] - 2026-05-04
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages bump
@@ -561,7 +566,6 @@ Patch cut — no breaking changes.
 ### No source 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 [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
@@ -575,7 +579,6 @@ Patch cut — no breaking changes.
 `a2ui-corpus` source is byte-identical to `0.2.1`. The cut bumps version only.
 
 ---
-
 ## [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 [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
@@ -640,7 +643,6 @@ New `scripts/build/under-harvest-audit.mjs` flags pages under `site/pages/{patte
 - Smoke side-effect: zettel score bumped 91 → 92; smoke validation flipped from `valid=false score=98/91` → `valid=true score=100/92`. The registry gaps were tripping validation upstream.
 
 Per-finding triage in [`docs/reports/playground-examples-review-2026-05-02.md`](../../../docs/reports/playground-examples-review-2026-05-02.md).
-
 ## [0.2.0] - 2026-05-02
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages now share one
@@ -672,7 +674,6 @@ caret-lock bug from the prior cut is resolved by the mcp package's
   paths swept to match the compose `engines/` → `strategies/` rename
   and the retrieval subdir reorganization. Pure path-string updates;
   no logic changes.
-
 ## [0.0.9] - 2026-05-01
 
 Pure-data refresh covering the §22-25 web-components arc. Catalog
@@ -717,7 +718,6 @@ release.
   Chunk count + shape unchanged; embedding index unaffected (only
   chunk-root attrs are indexed; `<avatar-ui>` is always nested in
   body HTML).
-
 ## [0.0.8] - 2026-05-01
 
 Pure-data refresh. Chunk re-harvest aligns the corpus with the
@@ -736,7 +736,6 @@ teach consumers to emit deprecated markup.
 - Catalog regenerated against `web-components@0.0.29` surface
   (`<feed-ui>` + `<feed-item-ui>` + `<swatch-ui>` family entries
   carried through, app-shell slot-vocabulary parity reflected).
-
 ## [0.0.7] - 2026-04-28
 
 ### Added
@@ -761,7 +760,6 @@ teach consumers to emit deprecated markup.
   Unlock: `compose_from_chunks(intent)` can now synthesize multi-step
   wizard pages and onboarding-tour pages on top of the existing
   admin-dashboard shape — 3× expansion of the page-kind catalog.
-
 ## [0.0.6] - 2026-04-28
 
 **Retires the legacy exemplar extract → ingest path.** The chunk corpus
@@ -794,7 +792,6 @@ that was running on every MCP server boot is gone.
 - The `exemplars/` source HTML + `<name>.yaml` partners stay in the
   tarball — useful for reference, but no longer feed the training
   pipeline by default.
-
 ## [0.0.5] - 2026-04-28
 
 Corpus refresh — drops a non-chunk-shaped entry and regenerates both
@@ -818,7 +815,6 @@ API impact beyond a slight retrieval-quality bump.
   Same provider / model / dims; just one fewer entry.
 - **`pattern-embeddings.json` regenerated** — same 113 × 1536d count;
   fresh timestamp.
-
 ## [0.0.4] - 2026-04-28
 
 Same-day follow-up to `0.0.3` shipped earlier today. Adds **semantic
@@ -862,7 +858,6 @@ Pure-data addition; no schema changes.
   similarity, blended 5× with keyword score). Real-LLM eval improved
   from 7/10 → **9/10 retrieval hits** out of 10 hold-out intents — only
   novel composites still need synthesis fallback.
-
 ## [0.0.3] - 2026-04-28
 
 Same-day extension after `0.0.2` shipped. Adds the **gen-UI training-chunk
@@ -906,7 +901,6 @@ existing pattern/fragment/composition surface unchanged.
   rules; harvester contract.
 - Inventory: [`docs/specs/genui-chunk-inventory-001.md`](../../../docs/specs/genui-chunk-inventory-001.md)
   — full list with intent labels + review status.
-
 ## [0.0.2] - 2026-04-27
 
 Three-day batch since `0.0.1`. Catalog regenerated against the
@@ -1009,7 +1003,6 @@ removed. Pure-data package — no executable code change.
   resolves to an existing pattern file.
 
 ---
-
 ## [0.0.1] - 2026-04-24
 
 First public release. Pure-data package: pattern corpus,
@@ -1061,7 +1054,6 @@ Domain breakdown:
 - navigation: 11
 - display, container: 3 each
 - settings, data-display, input: 1 each
-
 ## [0.1.0] — internal baseline (pre-public, predates 0.0.1)
 
 Initial version at the time the monorepo was established. Contains: