@adia-ai/a2ui-compose 0.7.24 → 0.7.25

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @adia-ai/a2ui-compose
 
+## [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 `strategies/` (`registry.js` + 5 `zettel/` files) — propagated from the repo-wide `docs/` → `.claude/docs/` migration (2026-07-01); no functional change.
+
 ## [0.7.24] — 2026-07-01
 
 ### Maintenance
@@ -323,7 +329,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
 
@@ -904,7 +910,7 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the v0.4.5 ove
 - **`compose/strategies/monolithic/generate-pro.js` + companion `_shared/fragment-expander.js` — fragment machinery removed (§37).** Fragments retired; 85 compositions inlined with previously-referenced fragment content. Expander deleted; its caller's try/catch in `generator-adapter.js` handles the absence gracefully.
 - **MCP server `mcp/server.js` (§37).** Removed `get_fragment` tool, simplified `zettel_stats`, updated imports + boot logs + engine description to reflect the post-fragment world.
 
-See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutting arc narrative + [docs/journal/2026/05/2026-05-12.md](../../../docs/journal/2026/05/2026-05-12.md) §§ 37 / 38 / 41 / 47 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](../../../.claude/docs/journal/2026/05/2026-05-12.md) §§ 37 / 38 / 41 / 47 for per-§ details.
 ## [0.4.3] - 2026-05-11
 
 ### Fixed
@@ -913,7 +919,7 @@ See root [CHANGELOG.md `[Unreleased]`](../../../CHANGELOG.md) for the cross-cutt
 
 ### Lockstep
 
-9-package coordinated PATCH cut to v0.4.3 (per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Source change scoped to `core/generator.js` + `strategies/zettel/state-cache.js`. Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale + thousands grouping + hold-to-repeat). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md) for the cut narrative.
+9-package coordinated PATCH cut to v0.4.3 (per [`.claude/docs/specs/package-architecture.md` § 15](../../../.claude/docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Source change scoped to `core/generator.js` + `strategies/zettel/state-cache.js`. Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale + thousands grouping + hold-to-repeat). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md) for the cut narrative.
 ## [0.4.2] - 2026-05-11
 
 ### Ride-along (no source changes)
@@ -952,7 +958,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
 
@@ -997,7 +1003,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
@@ -1022,7 +1028,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).
 
@@ -1032,7 +1038,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 + LLM subpath dropped.** 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 + LLM subpath dropped.** 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`.
 
 This is a **minor cut on top of v0.2.5 with one BREAKING change**: the `./llm` subpath export is removed. The LLM adapters that previously shipped under `@adia-ai/a2ui-compose/llm` now ship as their own package, `@adia-ai/llm` (9th lockstep member, first publish in this cut).
 
@@ -1077,9 +1083,9 @@ This is a **minor cut on top of v0.2.5 with one BREAKING change**: the `./llm` s
 Plus rewrite imports as shown above. The change is mechanical.
 ## [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-compose` 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-compose` rides along at version bump only — no source change.
 
 ### Changed
 
@@ -1087,7 +1093,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.
 
@@ -1107,7 +1113,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
@@ -1122,7 +1128,7 @@ Patch cut — no breaking changes.
 `@adia-ai/a2ui-compose` 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 + reasoning-panel emission fixes.** 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 + reasoning-panel emission fixes.** 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
 
@@ -1145,7 +1151,7 @@ Companion fix in `@adia-ai/a2ui-retrieval` Unreleased (web-research.js EXPLICIT/
 ---
 ## [0.2.1] - 2026-05-02
 
-**Lockstep cut + scope-drift gate at composer time + skeleton harvest + Tier-1 block filter + high-resolution session ticket trace.** 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 + scope-drift gate at composer time + skeleton harvest + Tier-1 block filter + high-resolution session ticket trace.** 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
 
@@ -1185,10 +1191,10 @@ The synthesizer now captures a `retrievalTrace` per attempt: Tier-1 hits with sc
 
 **Lockstep cut + boundary cleanup.** 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 also lands the `engine/` ↔ `engines/` collision fix from
 T3 of the
-[`docs/plans/packages-architecture-fixes-2026-05-02.md`](../../../.brain/archive/2026-Q2/PLAN-packages-architecture-fixes-2026-05-02.md)
+[`.claude/docs/plans/packages-architecture-fixes-2026-05-02.md`](../../../.brain/archive/2026-Q2/PLAN-packages-architecture-fixes-2026-05-02.md)
 plan.
 
 ### Changed
@@ -1207,14 +1213,14 @@ plan.
   internal imports were also rewritten by the same sweep (no behavior
   change). All internal imports updated in one sweep.
 - **`constitution.md` moved out of the package source** to
-  [`docs/specs/compose-constitution.md`](../../../docs/specs/compose-constitution.md)
+  [`.claude/docs/specs/compose-constitution.md`](../../../.claude/docs/specs/compose-constitution.md)
   so it doesn't ship in the published tarball. Pointer added in
   README.
 - **`package.json` `exports` map updated** with new keys (`./core`,
   `./strategies/registry`, `./strategies/zettel`); old keys
   (`./engine`, `./engines/registry`, `./engines/zettel`) retained as
   aliases for one release cycle and removed in the next major.
-- Spec [`docs/specs/package-architecture.md`](../../../docs/specs/package-architecture.md)
+- Spec [`.claude/docs/specs/package-architecture.md`](../../../.claude/docs/specs/package-architecture.md)
   bumped 0.5.0 → 0.6.0 with the directory tree updated to reflect the
   new layout; new § 15 documents the lockstep versioning policy.
 
@@ -1242,8 +1248,8 @@ zettel engine that turn `compose_from_chunks` from single-shot into a
 multi-turn surface, plus a first-class telemetry surface that auto-fires
 issue tickets on engine failure paths.
 
-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 (engine modules)

package/README.md

@@ -1,7 +1,7 @@
 # @adia-ai/a2ui-compose
 
 Framework-agnostic UI generation engine. Constitution doc:
-[`docs/specs/compose-constitution.md`](../../../docs/specs/compose-constitution.md).
+[`.claude/docs/specs/compose-constitution.md`](../../../.claude/docs/specs/compose-constitution.md).
 Takes a natural-language intent +
 an A2UI component catalog and produces a tree of A2UI protocol messages
 ready for a renderer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-compose",
-  "version": "0.7.24",
+  "version": "0.7.25",
   "description": "AdiaUI A2UI compose engine \u2014 framework-agnostic. Takes natural-language intents + a catalog and produces A2UI protocol messages. Pairs with `@adia-ai/a2ui-retrieval` (intent classification, catalog lookup) and `@adia-ai/a2ui-validator` (schema + semantic checks).",
   "type": "module",
   "exports": {

package/strategies/registry.js

@@ -1,6 +1,6 @@
 /**
  * Engine registry + dispatcher — the seam between gen-ui's public API and the
- * per-engine implementations. Per docs/specs/package-architecture.md §11 Phase 5.
+ * per-engine implementations. Per .claude/docs/specs/package-architecture.md §11 Phase 5.
  *
  * Two engines are currently wired:
  *   - monolithic  → pattern-match + adapt (instant | pro | thinking modes)

package/strategies/zettel/chunk-composer.js

@@ -19,7 +19,7 @@
  *     warnings: ["..."]                  // non-fatal issues
  *   }
  *
- * Plan: docs/plans/training-pipeline-chunk-harvest-2026-04-27.md (Phase C.2).
+ * Plan: .claude/docs/plans/training-pipeline-chunk-harvest-2026-04-27.md (Phase C.2).
  */
 
 import { getChunk } from '../../../corpus/scripts/chunk-library.js';

package/strategies/zettel/chunk-refiner.js

@@ -5,7 +5,7 @@
  * compositions from intent, the refiner takes a prior composition + intent
  * and emits ops that mutate it.
  *
- * Phase A scope (per docs/specs/genui-multiturn-architecture.md §4):
+ * Phase A scope (per .claude/docs/specs/genui-multiturn-architecture.md §4):
  *   - Two-pass synthesis (locator → modifier).
  *   - Validator-driven retry loop, default maxAttempts=2.
  *   - Op format: chunk-plan-level ops internally; A2UI-message-shaped on output.

package/strategies/zettel/chunk-synthesizer.js

@@ -16,7 +16,7 @@
  * Token-budget mitigation: pre-search filters the catalog to ~30 candidates
  * before the LLM sees them. Mirrors the fragment-synthesizer technique.
  *
- * Plan: docs/plans/training-pipeline-chunk-harvest-2026-04-27.md (Phase C.2).
+ * Plan: .claude/docs/plans/training-pipeline-chunk-harvest-2026-04-27.md (Phase C.2).
  */
 
 import {

package/strategies/zettel/issue-reporter.js

@@ -10,7 +10,7 @@
  * Every issue lands as immutable JSON under `.brain/audit-history/issues/`.
  * Traces > 200KB spill to a sidecar `.trace.json` next to the issue.
  *
- * Spec: docs/specs/genui-multiturn-architecture.md §3.5 + §4.6 + §11.
+ * Spec: .claude/docs/specs/genui-multiturn-architecture.md §3.5 + §4.6 + §11.
  *
  * Distinct from the curated `.tickets/` system (corpus/scripts/ticket.mjs):
  * those are human-authored work items. Issues here are runtime telemetry —
@@ -284,7 +284,7 @@ export async function reportIssue(input, ctx = {}) {
     suggested_owner: input.suggested_owner ?? 'unknown',
     tags: input.tags ?? [],
     related_issue_ids: ctx.related_issue_ids ?? [],
-    linked_specs: ctx.linked_specs ?? ['docs/specs/genui-multiturn-architecture.md'],
+    linked_specs: ctx.linked_specs ?? ['.claude/docs/specs/genui-multiturn-architecture.md'],
   };
 
   const path = join(storageRoot, `${issue_id}.json`);

package/strategies/zettel/state-cache.js

@@ -21,7 +21,7 @@
  *     created_at,          // ISO timestamp
  *   }
  *
- * Spec: docs/specs/genui-multiturn-architecture.md §2.2 + §4.4.
+ * Spec: .claude/docs/specs/genui-multiturn-architecture.md §2.2 + §4.4.
  */
 
 const DEFAULT_MAX_SIZE = 64;
@@ -104,7 +104,7 @@ export class StateCache {
  *  - unix-min — Math.floor(Date.now() / 60000), giving a compact minute-resolution
  *    timestamp that humans can scan for chronological order.
  *
- * Spec: docs/specs/genui-multiturn-architecture.md §2.2.
+ * Spec: .claude/docs/specs/genui-multiturn-architecture.md §2.2.
  *
  * @param {string} intent
  * @param {number} [version=1]