@adia-ai/a2ui-corpus 0.7.25 → 0.7.27

package/CHANGELOG.md

@@ -1,4 +1,14 @@
 # Changelog — @adia-ai/a2ui-corpus
+## [0.7.27] — 2026-07-12
+
+### Maintenance
+- **Chunk corpus re-harvested through the 0.7.27 transpiler** — chunk bodies now carry the fidelity fixes shipped in `@adia-ai/a2ui-compose` 0.7.27 (`[span]` preservation, `Tag` `text`-prop labels) and the `aria-label` propagation contract; embeddings index rebuilt to match (394 chunks × 1536d).
+- **Catalog (`catalog-a2ui_0_9.json`) regenerated** — picks up `richtext-ui`'s new `flush` prop from the yaml SoT.
+
+## [0.7.26] — 2026-07-04
+
+### Changed
+- **`catalog-a2ui_0_9_rules.txt` regenerated — `empty-state-ui`'s CTA guidance no longer prescribes `variant="outline"` for secondary/retry actions.** Ride-along regen from the `@adia-ai/web-components` `empty-state.yaml` `a2ui: rules:` fix (see that package's changelog for the root-cause investigation). Regenerated from the yaml SoT via `components.mjs` — never hand-edited.
 
 ## [0.7.25] — 2026-07-03
 
@@ -297,7 +307,7 @@ Patterns shipped: card-ui header/section/footer anatomy; row-ui header pattern;
 
 ### Maintenance
 
-- **Lockstep version bump only.** Peer's v0.6.32 absorbed the chunk + embeddings regen against the status:stable yaml sweep (recovery committed at `e864fc396` post peer's release commit `5285defa8`; see [`2026-05-23-freshness-gate-recovery-v0.6.32.md` case study](../../../.agents/skills/adia-ui-release/assets/case-studies/2026-05-23-freshness-gate-recovery-v0.6.32.md)).
+- **Lockstep version bump only.** Peer's v0.6.32 absorbed the chunk + embeddings regen against the status:stable yaml sweep (recovery committed at `e864fc396` post peer's release commit `5285defa8`; see `2026-05-23-freshness-gate-recovery-v0.6.32.md` case study (git history)).
 
 ## [0.6.31] — 2026-05-23
 
@@ -948,7 +958,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](../../../.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
@@ -1197,7 +1207,7 @@ Patch cut — no breaking changes.
 
 ### Changed — Trait registry now generated from web-components SoT (2026-05-02)
 
-`packages/a2ui/retrieval/catalog.js` no longer carries a hand-curated `traitRegistry` array. The trait list is loaded at module init from `packages/web-components/traits/_catalog.json` (generated by `node scripts/build/traits-catalog.mjs` in the monorepo root from live `defineTrait()` metadata). Per [ADR-0018](../../../.brain/adrs/0018-trait-source-of-truth-and-declarative-attribute.md).
+`packages/a2ui/retrieval/catalog.js` no longer carries a hand-curated `traitRegistry` array. The trait list is loaded at module init from `packages/web-components/traits/_catalog.json` (generated by `node scripts/build/traits-catalog.mjs` in the monorepo root from live `defineTrait()` metadata). Per `ADR-0018`.
 
 Behavior changes:
 - 4 phantom traits (`disabled-state`, `form-associated`, `value-sync`, `resettable`) no longer appear in MCP `get_traits` responses — they had no implementation in `traits/`. Auto-pruned by construction.
@@ -1245,11 +1255,11 @@ New `scripts/build/under-harvest-audit.mjs` flags pages under `site/pages/{patte
 ### Fixed — A2UI registry gap closure + ADR-0015 pattern migration (2026-05-02)
 
 - **Registry additions** in `@adia-ai/a2ui-utils`: `Field`, `Rating`, `ListItem`, `NavItem`, `NavGroup`. All 5 components existed; only the registry mapping was missing. Net effect on the corpus: 28/113 hand-authored patterns previously rendered with `[unknown: X]` placeholders when imported into `/site/playground/a2ui-editor`. After: 0/113 unknown.
-- **`patterns/navigation/section-subnav.json`** migrated per [ADR-0015 § Nav consolidation](../../../.brain/adrs/0015-three-tier-naming-convention.md). `SectionNav` → `Nav variant=section`; `SectionNavItem` → `NavItem`. The pattern was referencing the retired 6-element nav family.
+- **`patterns/navigation/section-subnav.json`** migrated per `ADR-0015 § Nav consolidation`. `SectionNav` → `Nav variant=section`; `SectionNavItem` → `NavItem`. The pattern was referencing the retired 6-element nav family.
 - **`patterns/layout/weather-widget.json`** — renamed `Metric` → `Stat` (no `<metric-ui>` exists; `Stat` is the canonical metric/value/change/trend primitive).
 - 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 [`.claude/docs/reports/playground-examples-review-2026-05-02.md`](../../../.claude/docs/reports/playground-examples-review-2026-05-02.md).
+Per-finding triage in `.claude/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
@@ -1299,12 +1309,12 @@ release.
   `<adia-chat-ui>`; `<editor-shell>` was `<adia-editor-ui>`;
   `<admin-shell>` was `<app-shell-ui>`; `<gen-root>` was
   `<gen-ui-ui>`; `<chat-thread-ui>` was `<chat-ui>`). Element renames
-  per [ADR-0015](../../../.brain/adrs/0015-three-tier-naming-convention.md);
+  per `ADR-0015`;
   nav consolidation per ADR-0015 § Nav consolidation. The 6-element
   nav family (`<app-nav-*>` + `<section-nav-*>`) collapsed into 3
   primitives. Synthesizer no longer emits the renamed-away tags.
 - **`yaml name:` fields swept** per
-  [ADR-0016](../../../.brain/adrs/0016-class-naming-convention.md) —
+  `ADR-0016` —
   primitives now `name: UI<X>` (was `Adia<X>`); modules now
   `name: <X>` without the `Adia` prefix. Consumers reading the
   catalog to cross-reference class names get the current convention.

package/README.md

@@ -61,7 +61,7 @@ hand-authored ungrounded JSON lives in `corpus/`.
 > retrievable equivalents were either (a) already represented in the
 > chunks corpus via annotated `data-chunk-*` regions, or (b) deemed
 > non-grounded under the locked rule and DELETE'd in §73 Mode-C triage
-> (target for v0.4.7). See [`.claude/docs/journal/2026/05/2026-05-12.md`](../../../.claude/docs/journal/2026/05/2026-05-12.md)
+> (target for v0.4.7). See `.claude/docs/journal/2026/05/2026-05-12.md`
 > §§ 36-§42, §65, §72 for the multi-arc retirement narrative.
 
 ## Layout

package/catalog-a2ui_0_9.json

@@ -19977,6 +19977,11 @@
         "component": {
           "const": "RichText"
         },
+        "flush": {
+          "description": "Paragraph-grade embedding mode — removes the article chrome (body padding and the 45rem reading measure, plus the trailing paragraph margin) so the rendered markdown sits flush in a host column like a plain text block. Use when richtext carries a single paragraph or fragment inside an already-measured layout (doc pages, cards); leave off for standalone articles and chat transcripts.",
+          "type": "boolean",
+          "default": false
+        },
         "markdown": {
           "description": "Component property: markdown.",
           "type": "string",

package/catalog-a2ui_0_9_rules.txt

@@ -257,7 +257,7 @@
 ## EmptyState
 - Use <empty-state-ui> for zero-data states: empty lists, no-results search, fresh accounts. Not for loading (use <skeleton-ui>). For inline notices within populated content use <alert-ui>. For full-section error states where the data cannot be shown at all (API failure, permission error), use <empty-state-ui variant="danger"> — the centered layout is more appropriate than an inline banner when the entire content area is replaced.
 - Canonical placement: slotted into cluster-specific wrappers — <chat-empty> inside <chat-thread>, <editor-canvas-empty> inside <editor-canvas>, OR inside <card-ui><section> for in-card empty states. Compose with an <icon-ui> for the leading glyph (pick a Phosphor name that mirrors the missing entity — folder, inbox, magnifying-glass).
-- Put AT MOST ONE CTA in slot="action". It should be the single next step (Create, Retry, Clear filters). Prefer [variant="primary"] for create-flows; [variant="outline"] for retry / secondary actions.
+- Put AT MOST ONE CTA in slot="action". It should be the single next step (Create, Retry, Clear filters). Use [variant="primary"] for a create-flow CTA; leave [variant] unset for retry / secondary actions — the default (no attribute) already IS the secondary look, so don't add [variant="outline"] just to mark something as non-primary.
 - Use [minimal] for inline empty rows inside <table-ui> / <list-ui> where full-canvas chrome is too prominent. The `minimal` flag (§223 v0.5.9) drops chrome for a compact placeholder cell.
 - Per ADR-0027, empty-state-ui composes <icon-ui> but does NOT auto-register it. Consumer pages must explicitly import <icon-ui> before <empty-state-ui> renders correctly.