@adia-ai/a2ui-mcp 0.7.24 → 0.7.25

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @adia-ai/a2ui-mcp
 
+## [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 reference corrected** (`docs/specs/...` → `.claude/docs/specs/...`) in `tools/synthesis.ts` — 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
 
@@ -644,7 +650,7 @@ Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4
 
 ### Added
 
-- `scripts/shadow-compare-classify.mjs` — Phase 3 shadow-compare classifier tool (139 lines). Compares the deterministic `classifyIntent` + `scoreAgainstSpec` (from `@adia-ai/a2ui-validator` Phase 3 foundation, shipped in v0.4.1) against the LLM judge baseline. Used to identify IntentSpecs eligible for fast-path promotion (`≥ 95%` agreement threshold per spec § 3c). First report at `docs/reports/semantic-shadow-compare-2026-05-10.md` flagged `auth.signin` + `auth.signup` as eligible. Surfaces alongside `npm run semantic:shadow-compare`.
+- `scripts/shadow-compare-classify.mjs` — Phase 3 shadow-compare classifier tool (139 lines). Compares the deterministic `classifyIntent` + `scoreAgainstSpec` (from `@adia-ai/a2ui-validator` Phase 3 foundation, shipped in v0.4.1) against the LLM judge baseline. Used to identify IntentSpecs eligible for fast-path promotion (`≥ 95%` agreement threshold per spec § 3c). First report at `.claude/docs/reports/semantic-shadow-compare-2026-05-10.md` flagged `auth.signin` + `auth.signup` as eligible. Surfaces alongside `npm run semantic:shadow-compare`.
 
 ### Ride-along (otherwise no source changes)
 
@@ -682,7 +688,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). Internal `@adia-ai/*` ranges stay at `^0.3.0` (patch-cut asymmetry — caret floats `0.3.x`).
+**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). Internal `@adia-ai/*` ranges stay at `^0.3.0` (patch-cut asymmetry — caret floats `0.3.x`).
 
 ### Added
 
@@ -720,7 +726,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`.
 
 ### Added
@@ -744,7 +750,7 @@ Internal `@adia-ai/*` dep ranges unchanged at `^0.3.0`.
 - `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).
 
@@ -754,7 +760,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 + new `@adia-ai/llm` dep.** 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 + new `@adia-ai/llm` dep.** 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 MCP synthesis tool now resolves `createLLMAdapter` from `@adia-ai/llm` (9th lockstep package, first publish in this cut) rather than `@adia-ai/a2ui-compose/llm` (subpath dropped). Behavior unchanged.
 
@@ -779,9 +785,9 @@ If you depend on `@adia-ai/a2ui-mcp` directly (typically as a CLI via `npx adiau
 `@adia-ai/llm` is a transitive dep — npm install handles it.
 ## [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-mcp` 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-mcp` rides along at version bump only — no source change.
 
 ### Changed
 
@@ -789,7 +795,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.
 
@@ -809,7 +815,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
@@ -824,7 +830,7 @@ Patch cut — no breaking changes.
 `@adia-ai/a2ui-mcp` source is byte-identical to `0.2.2`. The cut bumps version + the internal dep range entries 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
 
@@ -842,7 +848,7 @@ Patch cut — no breaking changes.
 ---
 ## [0.2.1] - 2026-05-02
 
-**Lockstep cut + `report_issue` trigger phrases + scope-drift auto-fire on canvas-drift detection.** 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 + `report_issue` trigger phrases + scope-drift auto-fire on canvas-drift detection.** 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
 
@@ -874,7 +880,7 @@ When the composer's scope-drift gate (a2ui-compose) flags `result.scopeDrift.dri
 
 **Lockstep cut + corpus caret-lock fix.** 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).
+[`.claude/docs/specs/package-architecture.md` § 15 (Versioning Policy)](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy).
 
 This release **fixes a live shipping bug** in 0.1.3: the `dependencies`
 range `"@adia-ai/a2ui-corpus": "^0.0.6"` locked to *exactly* `0.0.6`
@@ -915,7 +921,7 @@ BREAKING changes.
 
 - **`compose_from_chunks` eval runner + hold-out set**. Closes the
   spec at
-  [`docs/specs/compose-from-chunks-eval.md`](../../../docs/specs/compose-from-chunks-eval.md):
+  [`.claude/docs/specs/compose-from-chunks-eval.md`](../../../.claude/docs/specs/compose-from-chunks-eval.md):
   - `evals/compose-from-chunks-holdout.jsonl` — 20 intents (10
     single-turn compose + 10 multi-turn refine) across 9
     categories (data-display, forms, layout, data, data-viz,
@@ -945,7 +951,7 @@ BREAKING changes.
 ---
 ## [0.1.2] - 2026-05-01
 
-Phase 2 of [`docs/specs/semantic-validator.md`](../../../docs/specs/semantic-validator.md)
+Phase 2 of [`.claude/docs/specs/semantic-validator.md`](../../../.claude/docs/specs/semantic-validator.md)
 **promoted to default**. When `--semantic` is set, `eval-diff.mjs`
 now gates on the combined score at threshold 80 by default, instead
 of running in Phase 1 shadow-mode. **Behavior change** — see § Opt
@@ -1001,7 +1007,7 @@ Pass rate drops from 83 → 79 (4 percentage points), all justified.
 
 ### Updated baseline thresholds
 
-Per [`docs/specs/semantic-validator.md`](../../../docs/specs/semantic-validator.md)
+Per [`.claude/docs/specs/semantic-validator.md`](../../../.claude/docs/specs/semantic-validator.md)
 § Phase 2 status (2026-05-01):
 
 - `avgScore ≥ 88` (structural — unchanged)
@@ -1019,7 +1025,7 @@ Per [`docs/specs/semantic-validator.md`](../../../docs/specs/semantic-validator.
   threshold revalidation passes
 ## [0.1.1] - 2026-05-01
 
-Phase 2 of [`docs/specs/semantic-validator.md`](../../../docs/specs/semantic-validator.md)
+Phase 2 of [`.claude/docs/specs/semantic-validator.md`](../../../.claude/docs/specs/semantic-validator.md)
 — opt-in combined-gating in `eval-diff.mjs` + new
 `semantic-stats.mjs` companion script. **No breaking changes.**
 Default `eval-diff` behavior unchanged — Phase 1 shadow-mode is
@@ -1090,8 +1096,8 @@ MCP tools that turn the chunk-composition pipeline from single-shot into a
 multi-turn surface, plus extends `compose_from_chunks` to mint a `state_id`
 for refinement chains.
 
-Spec: [`docs/specs/genui-multiturn-architecture.md`](../../../docs/specs/genui-multiturn-architecture.md) (Active v0.1.0).
-Plan: [`docs/plans/genui-multiturn-rollout-2026-04-28.md`](../../../docs/plans/genui-multiturn-rollout-2026-04-28.md) (Phase A scoped).
+Spec: [`.claude/docs/specs/genui-multiturn-architecture.md`](../../../.claude/docs/specs/genui-multiturn-architecture.md) (Active v0.1.0).
+Plan: [`.claude/docs/plans/genui-multiturn-rollout-2026-04-28.md`](../../../.claude/docs/plans/genui-multiturn-rollout-2026-04-28.md) (Phase A scoped).
 ADR: [`0008-multiturn-genui-architecture.md`](../../../.brain/adrs/0008-multiturn-genui-architecture.md).
 
 ### Added (MCP tools)
@@ -1328,8 +1334,8 @@ before HTML is materialized.
 
 ### Convention reference
 
-- Spec: [`docs/specs/genui-chunk-marker.md`](../../../docs/specs/genui-chunk-marker.md).
-- Plan: [`docs/plans/training-pipeline-chunk-harvest-2026-04-27.md`](../../../docs/plans/training-pipeline-chunk-harvest-2026-04-27.md).
+- Spec: [`.claude/docs/specs/genui-chunk-marker.md`](../../../.claude/docs/specs/genui-chunk-marker.md).
+- Plan: [`.claude/docs/plans/training-pipeline-chunk-harvest-2026-04-27.md`](../../../.claude/docs/plans/training-pipeline-chunk-harvest-2026-04-27.md).
 
 ### Other
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-mcp",
-  "version": "0.7.24",
+  "version": "0.7.25",
   "description": "AdiaUI A2UI MCP server. Exposes the compose engine over MCP with an engine selector for monolithic + zettel strategies.",
   "type": "module",
   "bin": {

package/scripts/eval-compose-from-chunks.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * eval-compose-from-chunks.mjs — Hold-out eval for the chunk-aware
- * synthesizer. Per `docs/specs/compose-from-chunks-eval.md`.
+ * synthesizer. Per `.claude/docs/specs/compose-from-chunks-eval.md`.
  *
  * Reads `packages/a2ui/corpus/evals/holdout-compose-from-chunks.jsonl`,
  * runs each intent through `composeFromIntent`, and emits a per-intent
@@ -37,7 +37,7 @@
  *   npm run eval:compose-from-chunks -- --real-llm    # real-LLM
  *   npm run eval:compose-from-chunks -- --limit 5     # first 5 intents
  *   npm run eval:compose-from-chunks -- --json        # JSON report
- *   npm run eval:compose-from-chunks -- --report-file # write to docs/reports/
+ *   npm run eval:compose-from-chunks -- --report-file # write to .claude/docs/reports/
  */
 
 import '../../../../scripts/load-env.mjs';
@@ -247,7 +247,7 @@ async function main() {
 
   if (FLAG_REPORT) {
     const date = new Date().toISOString().slice(0, 10);
-    const dir = path.join(REPO_ROOT, 'docs/reports');
+    const dir = path.join(REPO_ROOT, '.claude/docs/reports');
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
     const file = path.join(dir, `eval-compose-from-chunks-${date}.md`);
     fs.writeFileSync(file, output + '\n');

package/scripts/eval-refine-synthesis.mjs

@@ -12,8 +12,8 @@
  *   - ≥ 90% of returned ops apply cleanly (validator + applyOps).
  *   - ≤  5 auto-fired issues across the full run (plan §1.8 #3).
  *
- * Spec: docs/specs/genui-multiturn-architecture.md (Active v0.1.0).
- * Plan: docs/plans/genui-multiturn-rollout-2026-04-28.md (Phase A).
+ * Spec: .claude/docs/specs/genui-multiturn-architecture.md (Active v0.1.0).
+ * Plan: .claude/docs/plans/genui-multiturn-rollout-2026-04-28.md (Phase A).
  *
  * Usage:
  *   ANTHROPIC_API_KEY=… node packages/a2ui/mcp/scripts/eval-refine-synthesis.mjs

package/scripts/semantic-stats.mjs

@@ -3,7 +3,7 @@
  * Compare two eval-diff run artifacts (JSON) and surface verdict-distribution
  * + pass-rate deltas. Used to verify "no unexplained regressions" between
  * baseline and a candidate gating-mode run, per Phase 2 exit criteria of
- * `docs/specs/semantic-validator.md`.
+ * `.claude/docs/specs/semantic-validator.md`.
  *
  * Usage:
  *   node packages/a2ui/mcp/scripts/semantic-stats.mjs <baseline.json> <candidate.json>

package/scripts/shadow-compare-classify.mjs

@@ -9,7 +9,7 @@
  *
  * Goal: identify which IntentSpecs the rule classifier agrees with the LLM
  * judge on ≥ 95% of the time. Those graduate to fast-path per
- * docs/specs/semantic-validator.md § Phase 3 exit criteria.
+ * .claude/docs/specs/semantic-validator.md § Phase 3 exit criteria.
  *
  * Note: the rule SCORER (scoreAgainstSpec) needs the emitted A2UI tree,
  * which is not stored in eval-diff archives. This tool measures only
@@ -134,6 +134,6 @@ if (withDisagreements.length > 0) {
 }
 
 console.log(`\n---\n`);
-console.log(`*Generated by \`shadow-compare-classify.mjs\` from \`packages/a2ui/validator/semantic/classify-intent.js\`. See [docs/specs/semantic-validator.md § Phase 3](../../../docs/specs/semantic-validator.md) for exit criteria.*`);
+console.log(`*Generated by \`shadow-compare-classify.mjs\` from \`packages/a2ui/validator/semantic/classify-intent.js\`. See [.claude/docs/specs/semantic-validator.md § Phase 3](../../../.claude/docs/specs/semantic-validator.md) for exit criteria.*`);
 
 process.exit(0);

package/scripts/smoke-issues.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // Smoke test: issue-reporter (write, trace attach, auto-fire, coalesce, evalMode).
-// Spec: docs/specs/genui-multiturn-architecture.md §3.5 + §4.6 + §6.4 + §11.
+// Spec: .claude/docs/specs/genui-multiturn-architecture.md §3.5 + §4.6 + §6.4 + §11.
 
 import {
   reportIssue,

package/scripts/smoke-refine.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // Smoke test: chunk-refiner (validator + applier + 2-pass synthesis with stub LLM).
-// Spec: docs/specs/genui-multiturn-architecture.md §4.
+// Spec: .claude/docs/specs/genui-multiturn-architecture.md §4.
 
 import {
   refineFromIntent,

package/scripts/smoke-state-cache.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // Smoke test: state-cache (LRU + state-id minting).
-// Spec: docs/specs/genui-multiturn-architecture.md §2.2 + §4.4.
+// Spec: .claude/docs/specs/genui-multiturn-architecture.md §2.2 + §4.4.
 import {
   StateCache,
   mintStateId,

package/scripts/test-a2ui.mjs

@@ -287,7 +287,7 @@ try {
 }
 
 // ── Test 7: Multi-turn refinement modules (Phase A) ─────────────────
-// Spec: docs/specs/genui-multiturn-architecture.md.
+// Spec: .claude/docs/specs/genui-multiturn-architecture.md.
 
 console.log('\n7. Multi-turn refinement (Phase A)');
 

package/scripts/test-chunks.mjs

@@ -7,7 +7,7 @@
  *
  * Wired into:
  *   - npm run smoke:chunks
- *   - Phase D verification gate (docs/plans/training-pipeline-chunk-harvest-2026-04-27.md)
+ *   - Phase D verification gate (.claude/docs/plans/training-pipeline-chunk-harvest-2026-04-27.md)
  */
 
 import {