@adia-ai/a2ui-validator 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -7,6 +7,34 @@ Follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 
 _No pending changes._
 
+## [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).
+
+### Changed
+
+- `version`: `0.3.2` → `0.3.3`.
+- `dependencies["@adia-ai/...]`: `^0.3.0` (patch-cut asymmetry — caret already covers 0.3.x; ranges unchanged).
+
+### No source changes
+
+`@adia-ai/a2ui-validator` source is byte-identical to `0.3.2`. The cut is a version bump + ride-along on the lockstep policy.
+
+## [0.3.2] - 2026-05-06
+
+**9-package lockstep patch cut to v0.3.2.** All lockstep members share
+one version per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy).
+Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
+
+### No source changes
+
+This package's source is byte-identical to v0.3.1. The cut bumps
+version only.
+
+### 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).

package/README.md

@@ -42,13 +42,61 @@ const result = validateAgainstCatalog(messages, catalog);
 - **Semantic validator** (optional, shadow-mode) — LLM-judged output
   quality against a rubric; cached on disk by content hash.
 
+## The 18 weighted checks
+
+`validator.js` runs 18 weighted checks that sum to 100. Default pass
+threshold is `valid: score ≥ 70`. The compose eval harness uses
+`combined: 0.6 × validation + 0.4 × semantic` at threshold 80, so a
+high structural score with low semantic still gets rejected at
+compose time.
+
+| Check | Weight | What it catches |
+|---|---:|---|
+| `intentAlignment` | 13 | Output addresses the intent (LLM-free heuristic) |
+| `allTypesRegistered` | 9 | Every `component` value exists in the runtime registry |
+| `noOrphanedChildren` | 9 | Every `children` ID resolves to a real node |
+| `validMessageFormat` | 8 | Top-level shape is valid A2UI |
+| `hasRootComponent` | 7 | Exactly one root |
+| `noBareDivs` | 7 | Use semantic primitives (`<card-ui>`, `<col-ui>`) not bare `<div>` |
+| `cardStructure` | 6 | Card pattern: header / body / footer hierarchy |
+| `flatAdjacency` | 5 | Component IDs are flat (no nested arrays) |
+| `noInlineLayout` | 5 | Use `<col-ui>` / `<row-ui>` / `<grid-ui>` not inline `style="display:flex"` |
+| `textContentSet` | 5 | Text components have actual content |
+| `idUniqueness` | 5 | No duplicate IDs |
+| `interactiveHasLabel` | 4 | Buttons / inputs have accessible labels |
+| `imagesHaveAlt` | 3 | `<img>` has `alt` attribute |
+| `headingHierarchy` | 3 | `h1` → `h2` → `h3` monotonic |
+| `gridVsColumn` | 3 | Right primitive for the layout |
+| `landmarkStructure` | 3 | Page-level `main` / `nav` / `footer` |
+| `noHardcodedColors` | 3 | Token contract — `--a-chrome-*` only |
+| `tabStructure` | 2 | `<tabs-ui>` has `<tab-ui>` children |
+| **Total** | **100** | |
+
+**Wiring checks** are tracked separately (don't roll into the component
+score) and sum to 13: `wiringControllersExist` (3), `wiringHostsExist`
+(3), `wiringHandlersExist` (3), `wiringSourcesExist` (2),
+`wiringDataPathsValid` (2).
+
+## Status
+
+- **Structural + catalog validation** — shipped, default-on. Single
+  source of truth for component-shape contracts in A2UI messages.
+- **Semantic validator (Phases 1 + 2)** — shipped. LLM-judge with
+  `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`](../../../docs/specs/semantic-validator.md):
+  rubric expansion, persisted per-intent thresholds, and judge
+  ensembling.
+
 ## Runtime
 
 - `ajv` + `ajv-formats` for structural validation.
 - `@adia-ai/a2ui-runtime` for the registry shape.
 
-## Links
+## Related
 
+- Spec: [`docs/specs/semantic-validator.md`](../../../docs/specs/semantic-validator.md) — canonical design narrative
+- Audit: [`docs/reports/audit-validator-2026-05-06.md`](../../../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)
-- Spec: [`docs/specs/semantic-validator.md`](https://github.com/adiahealth/gen-ui-kit/blob/main/docs/specs/semantic-validator.md)
 - CHANGELOG: [`CHANGELOG.md`](./CHANGELOG.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-validator",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "AdiaUI A2UI validator \u2014 JSON Schema structural validation plus catalog-aware semantic validation (component exists, props match YAML). Split out from the compose engine so non-compose tooling (tests, MCP validator tools, CI gates) can depend on validation without pulling the whole generator graph.",
   "type": "module",
   "main": "./index.js",