@adia-ai/a2ui-validator 0.5.18 → 0.5.20

package/CHANGELOG.md

@@ -6,6 +6,14 @@ Follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 
 _No pending changes._
 
+## [0.5.20] - 2026-05-18
+
+_Lockstep ride-along (no source change in this package; companion to web-components v0.5.20 — see root CHANGELOG)._
+
+## [0.5.19] - 2026-05-17
+
+_Lockstep ride-along (no source change in this package; companion to web-components v0.5.19 — see root CHANGELOG)._
+
 ## [0.5.18] - 2026-05-16
 
 _Lockstep ride-along (no source change in this package; companion to web-components v0.5.18 — see root CHANGELOG)._

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-validator",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "description": "AdiaUI A2UI validator — 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",

package/validator.js

@@ -14,24 +14,25 @@ import { registry, wiringRegistry } from '@adia-ai/a2ui-runtime';
 
 const WEIGHTS = {
   validMessageFormat:   8,
-  hasRootComponent:     7,
-  allTypesRegistered:   9,
-  noOrphanedChildren:   9,
-  cardStructure:        6,
-  flatAdjacency:        5,
-  noBareDivs:           7,
-  noHardcodedColors:    3,
-  noInlineLayout:       5,
-  textContentSet:       5,
-  idUniqueness:         5,
+  hasRootComponent:     6,
+  allTypesRegistered:   8,
+  noOrphanedChildren:   8,
+  cardStructure:        5,
+  flatAdjacency:        4,
+  noBareDivs:           6,
+  noHardcodedColors:    2,
+  noInlineLayout:       4,
+  textContentSet:       4,
+  idUniqueness:         4,
   interactiveHasLabel:  4,
-  imagesHaveAlt:        3,
-  headingHierarchy:     3,
+  imagesHaveAlt:        2,
+  headingHierarchy:     2,
   tabStructure:         2,
-  gridVsColumn:         3,
-  landmarkStructure:    3,
-  intentAlignment:     13,
-  componentsHaveRenderableContent: 6,  // §165 (v0.5.4) — the 3rd safety layer
+  gridVsColumn:         2,
+  landmarkStructure:    2,
+  intentAlignment:      7,
+  ontologyAlignment:   15,
+  componentsHaveRenderableContent: 5,  // §165 (v0.5.4) — the 3rd safety layer
 };
 
 /**
@@ -107,6 +108,7 @@ export function validateSchema(messages, options = {}) {
     checkGridVsColumn(allComponents),
     checkLandmarkStructure(allComponents),
     checkIntentAlignment(allComponents, options.intent),
+    checkOntologyAlignment(allComponents, options.context),
   ];
 
   // Wiring checks (only scored when wireComponents present)
@@ -128,7 +130,7 @@ export function validateSchema(messages, options = {}) {
   score = Math.round(score * 100);
 
   // Hard-fail: bare HTML elements or unregistered types mean the output is fundamentally wrong
-  const hardFails = ['noBareDivs', 'allTypesRegistered', 'hasRootComponent', 'tabStructure'];
+  const hardFails = ['noBareDivs', 'allTypesRegistered', 'hasRootComponent', 'tabStructure', 'ontologyAlignment'];
   const hasHardFail = checks.some(c => hardFails.includes(c.name) && !c.passed);
 
   // Severe intent mismatch: if intentAlignment score < 0.3 and intent was provided,
@@ -1097,6 +1099,37 @@ function checkIntentAlignment(components, intent) {
  * @param {Set<string>} componentIds — IDs from updateComponents
  * @returns {object[]} — Array of check results
  */
+function checkOntologyAlignment(components, context) {
+  if (!context || !context.domain || !context.domain.entities) {
+    return { name: 'ontologyAlignment', passed: true, score: 1, detail: 'No ontology context provided' };
+  }
+
+  // Check if at least one entity or task from the context appears in the components
+  const entities = context.domain.entities.map(e => e.toLowerCase());
+  const tasks = (context.tasks?.primary || []).map(t => t.toLowerCase());
+  const terms = [...entities, ...tasks];
+
+  if (terms.length === 0) {
+    return { name: 'ontologyAlignment', passed: true, score: 1, detail: 'Empty ontology context' };
+  }
+
+  const jsonStr = JSON.stringify(components).toLowerCase();
+  
+  const foundTerms = terms.filter(t => jsonStr.includes(t));
+  
+  // Need at least one term match. If 0, it hallucinates completely different data.
+  const score = foundTerms.length > 0 ? 1 : 0;
+  
+  return {
+    name: 'ontologyAlignment',
+    passed: score > 0,
+    score: score,
+    detail: score > 0 
+      ? `Ontology respected (Found terms: ${foundTerms.join(', ')})`
+      : `Ontology violation: None of the planned domain entities or tasks were found in the UI tree.`,
+  };
+}
+
 function checkWiring(wire, componentIds) {
   const checks = [];