@adia-ai/a2ui-validator 0.7.24 → 0.7.25

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @adia-ai/a2ui-validator
 
+## [0.7.25] — 2026-07-03
+
+### Maintenance
+- **Lockstep version bump.** No functional source changes; bumped to maintain the 9-package version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.7.25 work shipped in accordion-ui variant="flat|contained" posture + 2 footnote fixes + keyboard a11y. See `packages/web-components/CHANGELOG.md#0725--2026-07-03` for details.
+- **Doc-comment path references corrected** (`docs/specs/...` → `.claude/docs/specs/...`) across `semantic/` (`classify-intent.js`, `index.js`, `intent-specs.js`, `judge.js`) — propagated from the repo-wide `docs/` → `.claude/docs/` migration (2026-07-01); no functional change.
+
 ## [0.7.24] — 2026-07-01
 
 ### Maintenance
@@ -317,7 +323,7 @@
 ## [0.6.15] — 2026-05-21
 
 ### Maintenance
-- **Lockstep version bump only.** No source changes in this package; bumped to maintain the 9-package version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.6.15 work shipped in `@adia-ai/web-components` — `installIconLoaders` shape-detects malformed flat globs (FB-07 auto-promote + warn), `icons-phosphor.js` surfaces silent-fail diagnostics (FB-08), and docs/skill examples corrected (FB-09). See `packages/web-components/CHANGELOG.md#0615--2026-05-21` for details.
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the 9-package version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.6.15 work shipped in `@adia-ai/web-components` — `installIconLoaders` shape-detects malformed flat globs (FB-07 auto-promote + warn), `icons-phosphor.js` surfaces silent-fail diagnostics (FB-08), and .claude/docs/skill examples corrected (FB-09). See `packages/web-components/CHANGELOG.md#0615--2026-05-21` for details.
 
 ## [0.6.14] — 2026-05-21
 
@@ -614,14 +620,14 @@ Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4
 
 ### Added
 
-- **Semantic-validator Phase 3 foundation** (per [docs/specs/semantic-validator.md](../../../docs/specs/semantic-validator.md) § Phase 3 — rule-based fast-path):
+- **Semantic-validator Phase 3 foundation** (per [.claude/docs/specs/semantic-validator.md](../../../.claude/docs/specs/semantic-validator.md) § Phase 3 — rule-based fast-path):
   - `semantic/intent-specs.js` — registry of 10 `IntentSpec` entries covering dominant intent classes: `auth.signup`, `auth.signin`, `auth.password-reset`, `dashboard.analytics`, `data-table.list`, `form.settings`, `form.contact`, `chat.conversation`, `commerce.cart`, `errors.not-found`.
   - `semantic/classify-intent.js` — `classifyIntent()` regex classifier + `scoreAgainstSpec()` deterministic A2UI-tree scorer. Returns rule verdict with certainty 0..1 (≥ 0.9 = LLM-skip eligible per spec § 3c hybrid).
   - 18 unit tests covering registry hygiene, regex match against 6 dominant intents, clean-pass / clean-fail / partial-verdict scoring, nested A2UI tree traversal.
 
 ### Changed
 
-- Spec status updated in `docs/specs/semantic-validator.md` to reflect Phase 3 foundation shipped (NOT yet wired into `validateSemantics()` — integration deferred until shadow-compare runs prove ≥ 95% agreement with LLM judge).
+- Spec status updated in `.claude/docs/specs/semantic-validator.md` to reflect Phase 3 foundation shipped (NOT yet wired into `validateSemantics()` — integration deferred until shadow-compare runs prove ≥ 95% agreement with LLM judge).
 
 ### Notes
 
@@ -650,7 +656,7 @@ Lockstep version bump only — source byte-identical to v0.3.4. Internal `@adia-
 Lockstep version bump only — source byte-identical to v0.3.3. Internal `@adia-ai/*` dep ranges remain at `^0.3.0`. See root [CHANGELOG.md `## [0.3.4]`](../../../CHANGELOG.md) for the cut narrative.
 ## [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).
+**Lockstep cut.** All 9 published `@adia-ai/*` packages now share version `0.3.3`, governed by [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 
 ### Changed
 
@@ -663,7 +669,7 @@ Lockstep version bump only — source byte-identical to v0.3.3. Internal `@adia-
 ## [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).
+one version per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
 
 ### No source changes
@@ -676,7 +682,7 @@ version only.
 - `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).
+**9-package lockstep patch cut.** All 9 published `@adia-ai/*` packages bump 0.3.0 → 0.3.1 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/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).
 
 This package itself ships **no source changes** in v0.3.1. The cut bumps version only — substantive content lives in [`@adia-ai/web-components`](https://github.com/adiahealth/gen-ui-kit/releases/tag/web-components-v0.3.1) (folder-per-trait restructure; barrel API unchanged).
 
@@ -686,7 +692,7 @@ This package itself ships **no source changes** in v0.3.1. The cut bumps version
 - 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`.
+**9-package lockstep cut.** All 9 published `@adia-ai/*` packages bump 0.2.5 → 0.3.0 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges bump `^0.2.0` → `^0.3.0`.
 
 The lockstep policy expanded from 8 to 9 packages with this cut — `@adia-ai/llm` joins as a 9th member, and `@adia-ai/a2ui-utils` was renamed to `@adia-ai/a2ui-runtime`. This package's `dependencies` updated accordingly.
 
@@ -698,9 +704,9 @@ This package itself ships **no source changes** in v0.3.0. The cut bumps version
 - `version`: `0.2.5` → `0.3.0`.
 ## [0.2.5] - 2026-05-04
 
-**8-package lockstep cut.** 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). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.5 under semver — patch-cut asymmetry).
+**8-package lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.4 → 0.2.5 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.5 under semver — patch-cut asymmetry).
 
-This is a **patch cut on top of v0.2.4, no BREAKING changes.** Substantive content lives in `web-components` (new `<fields-ui>` form-grid primitive + `draggable-list-item` last-item drop-zone fix, both surfaced by the Tasks UI Playground at `docs/projects/tasks-playground/`); `a2ui-corpus` ships a catalog regen for the new `<fields-ui>` yaml. `a2ui-validator` rides along at version bump only — no source change.
+This is a **patch cut on top of v0.2.4, no BREAKING changes.** Substantive content lives in `web-components` (new `<fields-ui>` form-grid primitive + `draggable-list-item` last-item drop-zone fix, both surfaced by the Tasks UI Playground at `.claude/docs/projects/tasks-playground/`); `a2ui-corpus` ships a catalog regen for the new `<fields-ui>` yaml. `a2ui-validator` rides along at version bump only — no source change.
 
 ### Changed
 
@@ -708,7 +714,7 @@ This is a **patch cut on top of v0.2.4, no BREAKING changes.** Substantive conte
 - Internal `@adia-ai/*` dep ranges: unchanged at `^0.2.0` (covers `0.2.5` under semver — patch-cut asymmetry).
 ## [0.2.4] - 2026-05-04
 
-**8-package lockstep cut.** 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). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.4 under semver — patch-cut asymmetry).
+**8-package lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.3 → 0.2.4 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges remain at `^0.2.0` (covers 0.2.4 under semver — patch-cut asymmetry).
 
 This is a **patch cut on top of v0.2.3, no BREAKING changes.** Substantive content lives in `web-components` (Tier 4 trait library lift, 11 new traits + 2 architectural rewrites, plus accumulated bug fixes); `a2ui-corpus` ships a catalog regen for the new `<demo-toggle-ui>` primitive. Six packages ride along at version + dep-range bump.
 
@@ -728,7 +734,7 @@ _Nothing yet._
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages bump
 0.2.2 → 0.2.3 per
-[`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy).
+[`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 Patch cut — no breaking changes.
 
 ### Changed
@@ -740,7 +746,7 @@ Patch cut — no breaking changes.
 `@adia-ai/a2ui-validator` 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.
+**Lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.1 → 0.2.2 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
 
 ### Changed
 
@@ -753,7 +759,7 @@ Patch cut — no breaking changes.
 ---
 ## [0.2.1] - 2026-05-02
 
-**Lockstep cut.** 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.
+**Lockstep cut.** All 8 published `@adia-ai/*` packages bump 0.2.0 → 0.2.1 per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
 
 ### Changed
 
@@ -767,8 +773,8 @@ Patch cut — no breaking changes.
 ## [0.2.0] - 2026-05-02
 
 **Lockstep cut.** All 8 published `@adia-ai/*` packages now share one
-version, governed by [`docs/specs/package-architecture.md` § 15
-(Versioning Policy)](../../../docs/specs/package-architecture.md#15-versioning-policy).
+version, governed by [`.claude/docs/specs/package-architecture.md` § 15
+(Versioning Policy)](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 
 ### Changed
 
@@ -800,7 +806,7 @@ consolidation.
 - **Semantic validator** (`semantic/`) — optional LLM-judged rubric
   scoring in shadow mode. Disk-cached by content hash; gated behind
   `--semantic` flag in `eval-diff.mjs`. See
-  [`docs/specs/semantic-validator.md`](https://github.com/adiahealth/gen-ui-kit/blob/main/docs/specs/semantic-validator.md).
+  [`.claude/docs/specs/semantic-validator.md`](https://github.com/adiahealth/gen-ui-kit/blob/main/docs/specs/semantic-validator.md).
 
 ### Dependencies
 

package/README.md

@@ -85,7 +85,7 @@ score) and sum to 13: `wiringControllersExist` (3), `wiringHostsExist`
   `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):
+- **Phases 3–5** — planned per [`semantic-validator.md`](../../../.claude/docs/specs/semantic-validator.md):
   rubric expansion, persisted per-intent thresholds, and judge
   ensembling.
 
@@ -96,7 +96,7 @@ score) and sum to 13: `wiringControllersExist` (3), `wiringHostsExist`
 
 ## 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
+- Spec: [`.claude/docs/specs/semantic-validator.md`](../../../.claude/docs/specs/semantic-validator.md) — canonical design narrative
+- Audit: [`.claude/docs/reports/audit-validator-2026-05-06.md`](../../../.claude/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)
 - CHANGELOG: [`CHANGELOG.md`](./CHANGELOG.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-validator",
-  "version": "0.7.24",
+  "version": "0.7.25",
   "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",

package/semantic/classify-intent.js

@@ -1,7 +1,7 @@
 /**
  * Intent classifier — Phase 3 kickoff (semantic-validator)
  *
- * Spec: docs/specs/semantic-validator.md § Phase 3
+ * Spec: .claude/docs/specs/semantic-validator.md § Phase 3
  *
  * Two-stage classification:
  *

package/semantic/index.js

@@ -1,7 +1,7 @@
 /**
  * Semantic validator — public API (Phase 1: LLM-only, shadow mode).
  *
- * See docs/specs/semantic-validator.md §5.2 for the SemanticVerdict shape.
+ * See .claude/docs/specs/semantic-validator.md §5.2 for the SemanticVerdict shape.
  * Phase 1: LLM-judge only. Hybrid rule path is Phase 3.
  *
  * Usage:

package/semantic/intent-specs.js

@@ -1,7 +1,7 @@
 /**
  * IntentSpec Registry — Phase 3 kickoff (semantic-validator)
  *
- * Spec: docs/specs/semantic-validator.md § 5.1, § Phase 3
+ * Spec: .claude/docs/specs/semantic-validator.md § 5.1, § Phase 3
  *
  * An IntentSpec is a deterministic recipe for one common intent class.
  * The classify-intent.js classifier matches user prompts against these

package/semantic/judge.js

@@ -1,7 +1,7 @@
 /**
  * LLM judge for semantic A2UI validation (Phase 1: Anthropic only).
  *
- * Implements the rubric from docs/specs/semantic-validator.md §4 (recommendation
+ * Implements the rubric from .claude/docs/specs/semantic-validator.md §4 (recommendation
  * is pure 3a LLM-judge as first phase). Provider-agnostic shape per §5.3;
  * only Anthropic wired here.
  *