@adia-ai/adia-ui-forge 0.8.17 → 0.8.19

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-forge",
-  "version": "0.8.17",
+  "version": "0.8.19",
   "description": "Maintain the adia-ui (@adia-ai) framework itself \u2014 author primitives and shells, run the A2UI generation pipeline and its corpus, review gen-UI quality, sweep QA, cut releases, deploy. The maintainer counterpart to adia-factory (the consumer/app-author plugin).",
   "author": {
     "name": "Kim",

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog — adia-forge
 
+## [0.8.19] — 2026-07-27
+
+### Fixed
+- **`adia-release` promotes the repo-root CHANGELOG at cut time** (operator directive 2026-07-27). The cut promoted the 11 package changelogs but never the root one, so repo-level entries accumulated under `[Unreleased]` across five release windows (0.8.7 → 0.8.18) until an operator caught the pile-up in the site's Changelog panel. `promote-unreleased.mjs` gains the special target `root` (repo-root `CHANGELOG.md`, deliberately outside `PACKAGE_ROSTER` — the roster feeds publish/tag consumers); `release-pack.mjs` adds `root` to the promote list by detection whenever that file's `[Unreleased]` carries content — no flag, since root entries are optional per window — and the post-promotion loud guard now sweeps `root` too, which also catches a duplicate `[Unreleased]` heading (the promote swaps only the first; the second trips the guard).
+
+### Maintenance
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+- **`skills/` touched in this release window** (3 file(s), e.g. `references/changelog-discipline.md`) — carried by the entries above.
+
+## [0.8.18] — 2026-07-27
+
+### Added
+- **`adia-author` writes down the tag-naming rule across tiers** (`references/code-style.md`) — primitives and standalone feature composites carry `-ui`; shell/bespoke-cluster children and runtime roots are bare, namespaced by their cluster prefix. Ratified when `form-popover` shipped as the only unsuffixed standalone composite (renamed `form-popover-ui` the next release); `theme-panel` is explicitly grandfathered, not precedent.
+
+### Maintenance
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+- **`skills/` touched in this release window** (1 file(s), e.g. `references/code-style.md`) — carried by the entries above.
+
 ## [0.8.17] — 2026-07-27
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/adia-ui-forge",
-  "version": "0.8.17",
+  "version": "0.8.19",
   "description": "Maintain the adia-ui (@adia-ai) framework itself \u2014 author primitives and shells, run the A2UI generation pipeline and its corpus, review gen-UI quality, sweep QA, cut releases, deploy. The maintainer counterpart to adia-factory (the consumer/app-author plugin).",
   "keywords": [
     "adia-ui",

package/skills/adia-author/references/code-style.md

@@ -24,6 +24,24 @@ Every interactive surface, form control, layout container, and content block shi
 
 The catalog has 125 component directories under `packages/web-components/components/`. Before composing, confirm via `get_component_map` (the a2ui MCP) that the one you want exists — and what its real prop names are.
 
+### Tag naming across tiers (`-ui` or bare)
+
+Two rules cover every tag in the monorepo (ratified 2026-07-27, when
+`form-popover` shipped as the only standalone composite without the
+suffix and was renamed to `form-popover-ui` one release later):
+
+| Tier | Convention | Examples |
+| --- | --- | --- |
+| Primitives (`packages/web-components`) | **always `-ui`** | `button-ui`, `select-ui`, `nav-item-ui` |
+| Standalone feature composites (`packages/web-modules`) — drop-in anywhere, consumer-facing | **always `-ui`** | `confirm-dialog-ui`, `plan-picker-ui`, `date-range-selector-ui`, `form-popover-ui` |
+| Shell/bespoke-cluster children + runtime roots | **bare** — the cluster prefix is the namespace | `admin-topbar`, `chat-composer`, `editor-canvas`, `simple-shell`, `a2ui-root`, `gen-root` |
+
+`theme-panel` (bare, standalone) predates this rule and is grandfathered —
+do not copy it as precedent for a new standalone composite. The DIRECTORY
+name never carries the suffix in either tier (`plan-picker/` →
+`<plan-picker-ui>`), and the a2ui `component:` name is unaffected
+(`FormPopover`).
+
 ## Layout primitives
 
 Use `<col-ui>`, `<row-ui>`, `<grid-ui>`, `<stack-ui>` for layout — never a bare `<div>`. The primitives carry the project's spacing scale (`gap`, padding tokens) and respond to density / theme providers; a plain `<div>` strands content outside that system.

package/skills/adia-release/references/changelog-discipline.md

@@ -22,7 +22,7 @@ node "${CLAUDE_PLUGIN_ROOT}/skills/adia-release/scripts/promote-unreleased.mjs"
   --version 0.X.Y --date YYYY-MM-DD --packages web-components,web-modules,a2ui/corpus
 ```
 
-(Package args take both name and path form — `a2ui-corpus` and `a2ui/corpus` both resolve, via `package-paths.mjs`.)
+(Package args take both name and path form — `a2ui-corpus` and `a2ui/corpus` both resolve, via `package-paths.mjs`. The special target `root` is the repo-root CHANGELOG.md; release-pack adds it automatically whenever that file's `[Unreleased]` carries content, so it never needs listing in `--substantive-packages`.)
 
 Non-clean cases:
 

package/skills/adia-release/scripts/promote-unreleased.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 // promote-unreleased.mjs — promote `## [Unreleased]` → `## [vX.Y.Z] — DATE`
-// in N package CHANGELOGs.
+// in N package CHANGELOGs. The special target `root` is the repo-root
+// CHANGELOG.md — same swap, no package resolution.
 //
 // Idempotent. Stops if any target already has the [vX.Y.Z] heading
 // (means you've already run this; would create a duplicate block).
@@ -54,8 +55,11 @@ function parseArgs(argv) {
 }
 
 function promote(repo, pkg, version, date, dry) {
-  // Accept both name-form (a2ui-corpus) and path-form (a2ui/corpus). See package-paths.mjs.
-  const p = resolvePackageChangelog(repo, pkg);
+  // Accept both name-form (a2ui-corpus) and path-form (a2ui/corpus) — see
+  // package-paths.mjs — plus `root` for the repo-root CHANGELOG (deliberately
+  // NOT in PACKAGE_ROSTER: the roster feeds publish/tag consumers, and the
+  // root file is no package).
+  const p = pkg === 'root' ? path.join(repo, 'CHANGELOG.md') : resolvePackageChangelog(repo, pkg);
   if (!fs.existsSync(p)) {
     console.error(`  ERROR ${pkg} — CHANGELOG.md not found at ${p}`);
     return 'missing';
@@ -112,6 +116,14 @@ function selftest() {
     const r2 = promote(tmp, 'web-components', '0.2.0', '2026-02-02', false);
     if (r2 !== 'already-promoted') { console.error(`selftest FAIL: expected 'already-promoted' on re-run, got '${r2}'`); process.exit(1); }
 
+    // `root` target resolves to <repo>/CHANGELOG.md, no package resolution.
+    const rootPath = path.join(tmp, 'CHANGELOG.md');
+    fs.writeFileSync(rootPath, '# Root\n\n## [Unreleased]\n\n### Added\n- z\n\n## [0.1.0] — 2026-01-01\n\n- y\n');
+    const r3 = promote(tmp, 'root', '0.2.0', '2026-02-02', false);
+    if (r3 !== 'promoted') { console.error(`selftest FAIL: expected 'promoted' for root, got '${r3}'`); process.exit(1); }
+    const rootOut = fs.readFileSync(rootPath, 'utf8');
+    if (!rootOut.includes('## [0.2.0] — 2026-02-02') || rootOut.includes('## [Unreleased]')) { console.error('selftest FAIL: root heading not swapped'); process.exit(1); }
+
     console.log('selftest OK');
   } finally {
     fs.rmSync(tmp, { recursive: true, force: true });

package/skills/adia-release/scripts/release-pack.mjs

@@ -312,17 +312,24 @@ function step3PreFlight(args) {
 // v0.8.4 cut — the plugin packages needed hand-promotion because nothing
 // caught it). Returns null when clean, or a short description when dirty.
 function unpromotedUnreleased(repo, pkg) {
-  const p = resolvePackageChangelog(repo, pkg);
+  // `root` = the repo-root CHANGELOG — no package resolution. It went
+  // unwatched until 2026-07-27, when five windows of repo-level entries
+  // (0.8.7 → 0.8.18) were found piled up under [Unreleased].
+  const p = pkg === 'root' ? path.join(repo, 'CHANGELOG.md') : resolvePackageChangelog(repo, pkg);
   if (!fs.existsSync(p)) return null;
   const txt = fs.readFileSync(p, 'utf8');
-  const m = txt.match(/^## \[Unreleased\][^\n]*\n([\s\S]*?)(?=^## \[|$(?![\s\S]))/m);
-  if (!m) return null;
-  // Strip subsection headers (### Added, ### Fixed, …) and blank lines — what's
-  // left is real content, not just empty scaffolding.
-  const body = m[1].replace(/^###.*$/gm, '').trim();
-  if (body.length === 0) return null;
-  const firstLine = body.split('\n')[0].slice(0, 100);
-  return `${pkg}: "${firstLine}${firstLine.length === 100 ? '…' : ''}"`;
+  // EVERY [Unreleased] block, not just the first: with duplicate headings an
+  // empty first + non-empty second would otherwise read clean while the
+  // promote (which swaps only the first heading) strands the content.
+  for (const m of txt.matchAll(/^## \[Unreleased\][^\n]*\n([\s\S]*?)(?=^## \[|$(?![\s\S]))/gm)) {
+    // Strip subsection headers (### Added, ### Fixed, …) and blank lines — what's
+    // left is real content, not just empty scaffolding.
+    const body = m[1].replace(/^###.*$/gm, '').trim();
+    if (body.length === 0) continue;
+    const firstLine = body.split('\n')[0].slice(0, 100);
+    return `${pkg}: "${firstLine}${firstLine.length === 100 ? '…' : ''}"`;
+  }
+  return null;
 }
 
 // ── Step 4 — Promote + bump + lockfile ───────────────────────────
@@ -338,8 +345,14 @@ function step4PromoteAndBump(args) {
   // (whether a peer already promoted vs. this cycle authoring fresh) differs,
   // not whether promotion is needed. `--substantive-packages` is the same flag
   // in both modes.
-  if (args.substantivePackages) {
-    const cmd = `node ${SCRIPT_DIR}/promote-unreleased.mjs --version ${args.version} --date ${args.date} --packages ${args.substantivePackages.join(',')}`;
+  // Root CHANGELOG rides on detection, not a flag: repo-level entries are
+  // optional per window, so `root` joins the promote list exactly when its
+  // [Unreleased] carries real content. A repo-level-only window (0.8.7 was
+  // one) promotes root with zero substantive packages.
+  const promoteTargets = [...(args.substantivePackages ?? [])];
+  if (unpromotedUnreleased(REPO, 'root')) promoteTargets.push('root');
+  if (promoteTargets.length > 0) {
+    const cmd = `node ${SCRIPT_DIR}/promote-unreleased.mjs --version ${args.version} --date ${args.date} --packages ${promoteTargets.join(',')}`;
     sh(cmd, args);
   }
 
@@ -353,16 +366,20 @@ function step4PromoteAndBump(args) {
   // carry a non-empty [Unreleased] — that content would ride through the
   // bump unpromoted, undocumented in the tarball's own CHANGELOG.
   if (!args.dry) {
-    const dirty = PACKAGES.map((p) => unpromotedUnreleased(REPO, p)).filter(Boolean);
+    // `root` in the sweep also catches a DUPLICATE [Unreleased] heading (the
+    // promote swaps only the first occurrence, so a second one survives to
+    // trip this guard — the 0.8.18 root file had exactly that shape).
+    const dirty = [...PACKAGES, 'root'].map((p) => unpromotedUnreleased(REPO, p)).filter(Boolean);
     if (dirty.length > 0) {
-      console.error(`\nERROR: ${dirty.length} package(s) still have non-empty [Unreleased] content after promotion:`);
+      console.error(`\nERROR: ${dirty.length} target(s) still have non-empty [Unreleased] content after promotion:`);
       for (const d of dirty) console.error(`  ✗ ${d}`);
       console.error('\n  Add the missing package(s) to --substantive-packages (or --stub-packages if');
-      console.error('  they are pure ride-alongs) and re-run. See changelog-discipline.md §Detecting');
-      console.error('  source-changing packages.');
+      console.error('  they are pure ride-alongs) and re-run; a dirty `root` means a duplicate');
+      console.error('  [Unreleased] heading in the repo-root CHANGELOG — merge the blocks by hand.');
+      console.error('  See changelog-discipline.md §Detecting source-changing packages.');
       process.exit(1);
     }
-    console.log(`  ✓ no unpromoted [Unreleased] content across all ${PACKAGES.length} packages`);
+    console.log(`  ✓ no unpromoted [Unreleased] content across all ${PACKAGES.length} packages + root`);
   }
 
   sh(`node ${SCRIPT_DIR}/bump.mjs --from ${args.previous} --to ${args.version}`, args);