@adia-ai/adia-ui-forge 0.8.32 → 0.8.34

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-ui-kit-forge",
-  "version": "0.8.32",
+  "version": "0.8.34",
   "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,25 @@
 # Changelog — adia-ui-kit-forge
 
+## [0.8.34] — 2026-08-11
+
+### Fixed
+- **Top-level `bin/` directory renamed to `scripts/` — claude.ai-hosted plugin validation was rejecting this plugin outright (gh#934).** claude.ai auto-adds any plugin's top-level `bin/` to PATH on the CLI, which isn't shown on the admin approval surface, so hosted validation refused to approve the plugin at all ("2 plugins found, 2 failed validation" alongside `adia-ui-kit-factory`, same defect). `bin/demo-postwrite-pattern-gate`, `bin/forge-lint`, `bin/release-pretag-docs-gate`, `bin/sidecar-prewrite-guard`, `bin/site-postwrite-derivation-gate` moved to `scripts/` with executable bits preserved; `hooks/hooks.json`'s `${CLAUDE_PLUGIN_ROOT}/bin/...` commands and `scripts/forge-lint`'s cross-reference to the factory plugin's vendored lint copy updated to `scripts/...`; `package.json`'s `files` array updated so the published tarball ships the renamed directory. Hook gates still fire the same scripts, just from a non-PATH-reserved location.
+
+### 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/canonical-pattern-index.md`) — carried by the entries above.
+
+## [0.8.33] — 2026-08-11
+
+### Fixed
+- **adia-release `release-pack.mjs` resume completes missing stubs, defers versionArg gates, warns on stale cache copy.** The half-cut-tree resume path (all 13 package versions already bumped) previously assumed Step 4a's promote/stub pass had also fully completed — but a stub package's `[Unreleased]` reads empty either way, so a resume after an abort mid-stub silently skipped it rather than completing it, leaving that package's `[X.Y.Z]` section missing entirely at tag time. Resume now re-runs `insert-stub.mjs` for any package still missing its `[X.Y.Z]` heading before continuing to the idempotent substeps, defers gates that need the CUT-version hygiene check until after that repair, and warns when the plugin's own bundled copy of this script differs from the repo's live one (a stale marketplace cache silently running old release logic). `cut-procedure.md`'s 4-resume section documents the corrected sequencing.
+- **`adia-gen-review`'s corpus-HTML pattern reference no longer teaches the retired `badge-ui variant="accent"` (gh#873-876).** Its worked example used the value the variant/color/tone convention cut retired in favor of `primary` — updated so the reference doesn't contradict the shipped contract.
+- **adia-release `release-pack.mjs` Step 5 now stages `catalog-data.js`, the third file `derive-genui-catalog.mjs` writes.** Found live during this cut: Step 4d.5 regenerates `base.json`/`adia-pack.json`/`catalog-data.js` together (the latter is the browser-safe ES-module projection of the first two), but the Step 5 file allowlist (gh#617) only ever named the first two — `catalog-data.js` sat modified-but-uncommitted in the release commit, invisible in a local working tree (the file exists, just stale) but caught immediately by CI's fresh checkout via `check:genui-catalog`'s drift check. Added to the allowlist alongside its siblings.
+
+### 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/corpus-html-patterns.md`) — carried by the entries above.
+
 ## [0.8.32] — 2026-08-09
 
 ### Fixed

package/hooks/hooks.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/bin/sidecar-prewrite-guard\" --hook"
+            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/sidecar-prewrite-guard\" --hook"
           }
         ]
       },
@@ -15,7 +15,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/bin/release-pretag-docs-gate\" --hook",
+            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/release-pretag-docs-gate\" --hook",
             "timeout": 90
           }
         ]
@@ -27,15 +27,15 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/bin/forge-lint\" --hook"
+            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/forge-lint\" --hook"
           },
           {
             "type": "command",
-            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/bin/demo-postwrite-pattern-gate\" --hook"
+            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/demo-postwrite-pattern-gate\" --hook"
           },
           {
             "type": "command",
-            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/bin/site-postwrite-derivation-gate\" --hook"
+            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/site-postwrite-derivation-gate\" --hook"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/adia-ui-forge",
-  "version": "0.8.32",
+  "version": "0.8.34",
   "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",
@@ -22,7 +22,7 @@
     "agents",
     "commands",
     "references",
-    "bin",
+    "scripts",
     "hooks",
     "README.md",
     "CHANGELOG.md"

package/{bin → scripts}/forge-lint

@@ -19,7 +19,7 @@ A clean forge-lint says "no structural tells," never "this is right."
 
 Shared core: the regex bank below (RAW-COLOR/PX, SCOPE-EXTENT, NATIVE-PRIMITIVE, LEGACY-SHELL,
 the _is_foundation_css exemption) is mirrored in the sibling CONSUMER plugin's
-adia-ui-factory/bin/adia-lint. They are deliberate VENDORED copies — the catalog forbids
+adia-ui-factory/scripts/adia-lint. They are deliberate VENDORED copies — the catalog forbids
 cross-plugin imports (each plugin installs copy-alone) — so any change to a shared rule must be
 reconciled in BOTH files. forge-lint drops the consumer/app traps (SSR double-router, top-level
 import, hardcoded overlay open) and adds MISSING-SCOPE; that divergence is the point.

package/skills/adia-author/references/canonical-pattern-index.md

@@ -2,7 +2,7 @@
 
 **Auto-generated** by this skill's `scripts/build-canonical-pattern-index.mjs`. Do not edit by hand — re-run the build script (from the monorepo root) after adding new canonicals to `apps/`, `catalog/`, or `playgrounds/`.
 
-**Total canonical `.contents.html` files**: 111
+**Total canonical `.contents.html` files**: 116
 
 ## How to use this index
 
@@ -105,14 +105,15 @@
 - `catalog/ui-patterns/app/chat-streaming-surface/chat-streaming-surface.contents.html` — 16 lines (from UI-pattern atomics (catalog))
 - `catalog/page-shells/app/chat-page/chat-page.contents.html` — 67 lines (from Page-shell templates (catalog))
 
-## editor (6)
+## editor (7)
 
 > Editor panes (code, preview, toolbar). Lift editor-shell composition.
 
 - `apps/genui/app/a2ui-editor/a2ui-editor.contents.html` — 261 lines (from GenUI app routes)
-- `apps/genui/app/render-preview/render-preview.contents.html` — 74 lines (from GenUI app routes)
+- `apps/genui/app/render-preview/render-preview.contents.html` — 93 lines (from GenUI app routes)
 - `catalog/ui-patterns/app/editor-code-pane/editor-code-pane.contents.html` — 16 lines (from UI-pattern atomics (catalog))
 - `catalog/ui-patterns/app/editor-preview-pane/editor-preview-pane.contents.html` — 13 lines (from UI-pattern atomics (catalog))
+- `catalog/ui-patterns/app/split-pane-editor/split-pane-editor.contents.html` — 31 lines (from UI-pattern atomics (catalog))
 - `catalog/page-shells/app/doc-editor/doc-editor.contents.html` — 65 lines (from Page-shell templates (catalog))
 - `catalog/page-shells/app/editor-page/editor-page.contents.html` — 25 lines (from Page-shell templates (catalog))
 
@@ -156,7 +157,7 @@
 
 > Activity / event feeds. Lift activity-feed composition.
 
-- `apps/genui/app/gen-ui-feed/gen-ui-feed.contents.html` — 392 lines (from GenUI app routes)
+- `apps/genui/app/gen-ui-feed/gen-ui-feed.contents.html` — 390 lines (from GenUI app routes)
 - `catalog/ui-patterns/app/order-tracking-timeline/order-tracking-timeline.contents.html` — 45 lines (from UI-pattern atomics (catalog))
 
 ## marketing (2)
@@ -185,11 +186,12 @@
 - `apps/genui/app/css-channel-demo/css-channel-demo.contents.html` — 70 lines (from GenUI app routes)
 - `apps/genui/app/streams-bridge/streams-bridge.contents.html` — 80 lines (from GenUI app routes)
 
-## other (40)
+## other (44)
 
 > Misc canonicals. Inspect contents.html to determine UI type.
 
 - `apps/genui/app/gen-ui/gen-ui.contents.html` — 47 lines (from GenUI app routes)
+- `apps/genui/app/patient-visit/patient-visit.contents.html` — 58 lines (from GenUI app routes)
 - `apps/user-flow/app/auth/accept-invite/accept-invite.contents.html` — 52 lines (from User-flow templates)
 - `apps/user-flow/app/auth/forgot-password/sent/sent.contents.html` — 33 lines (from User-flow templates)
 - `apps/user-flow/app/auth/sign-in/magic-link/sent/sent.contents.html` — 35 lines (from User-flow templates)
@@ -216,6 +218,7 @@
 - `apps/user-flow/app/registration/use-case/use-case.contents.html` — 77 lines (from User-flow templates)
 - `apps/user-flow/app/registration/workspace/workspace.contents.html` — 45 lines (from User-flow templates)
 - `catalog/ui-patterns/app/email-inbox-list/email-inbox-list.contents.html` — 135 lines (from UI-pattern atomics (catalog))
+- `catalog/ui-patterns/app/filter-popover-form/filter-popover-form.contents.html` — 22 lines (from UI-pattern atomics (catalog))
 - `catalog/ui-patterns/app/import-mapping/import-mapping.contents.html` — 217 lines (from UI-pattern atomics (catalog))
 - `catalog/ui-patterns/app/loading-skeleton-placeholder/loading-skeleton-placeholder.contents.html` — 62 lines (from UI-pattern atomics (catalog))
 - `catalog/ui-patterns/app/product-card-buy/product-card-buy.contents.html` — 39 lines (from UI-pattern atomics (catalog))
@@ -226,6 +229,8 @@
 - `catalog/page-shells/app/form-page/form-page.contents.html` — 26 lines (from Page-shell templates (catalog))
 - `catalog/page-shells/app/gallery-page/gallery-page.contents.html` — 79 lines (from Page-shell templates (catalog))
 - `playgrounds/admin-shell/app/admin-shell.contents.html` — 99 lines (from Playgrounds)
+- `playgrounds/agent-admin/app/agent-admin.contents.html` — 29 lines (from Playgrounds)
+- `playgrounds/agent-chat/app/agent-chat.contents.html` — 28 lines (from Playgrounds)
 - `playgrounds/chat/app/chat.contents.html` — 49 lines (from Playgrounds)
 - `playgrounds/composed-flow/app/composed-flow.contents.html` — 294 lines (from Playgrounds)
 - `playgrounds/table-toolbar/app/table-toolbar.contents.html` — 31 lines (from Playgrounds)

package/skills/adia-gen-review/references/corpus-html-patterns.md

@@ -113,7 +113,7 @@ matches both native `h1–h6`/`p` and their transpiled
 <header>
   <span slot="heading">
     <text-ui strong>Title</text-ui>
-    <badge-ui text="New" variant="accent"></badge-ui>
+    <badge-ui text="New" variant="primary"></badge-ui>
   </span>
   <p slot="description">Subtitle</p>
 </header>

package/skills/adia-release/references/cut-procedure.md

@@ -177,14 +177,22 @@ checks them itself at startup (gh#765):
 
 The fully manual fallback (both shapes, if the orchestrator itself is
 suspect) remains the standalone pieces the Mechanization section names, in
-this order:
+this order. **Stubs complete BEFORE 4f** (the v0.8.32 resume proved the
+ordering): the bump-complete marker cannot see whether insert-stub ran — a
+stub package's `[Unreleased]` is empty, so every guard passes with its
+`[X.Y.Z]` section entirely absent; running the coverage `--fix` before the
+stub sections exist leaves it nothing to append to, and the gap resurfaces
+as F-N1 warns at the push boundary, costing a tag move:
 
 ```bash
-node "${CLAUDE_PLUGIN_ROOT}/skills/adia-release/scripts/bump.mjs" --from X.Y.Z-1 --to X.Y.Z   # 4b
+node "${CLAUDE_PLUGIN_ROOT}/skills/adia-release/scripts/insert-stub.mjs" \
+  --version X.Y.Z --date YYYY-MM-DD --previous-version X.Y.Z-1 \
+  --substantive "<one-line>" --xref "<anchor>" --packages <missing-stubs>   # 4a-stub — FIRST, only the missing ones (hard-errors on existing sections)
+node "${CLAUDE_PLUGIN_ROOT}/skills/adia-release/scripts/bump.mjs" --from X.Y.Z-1 --to X.Y.Z   # 4b (skip if versions already moved)
 npm install --package-lock-only --no-audit --no-fund                                          # 4c
 npm run check:lockstep                                                                        # 4d
 node scripts/build/derive-genui-catalog.mjs                                                   # 4d.5 — catalogId carries the bumped version (gh#617)
-node scripts/release/check-release.mjs --pending-version X.Y.Z --fix                          # 4f
+node scripts/release/check-release.mjs --pending-version X.Y.Z --fix                          # 4f — AFTER the stubs exist
 node scripts/release/generate-release-notes.mjs --version X.Y.Z --write                       # 4e
 node scripts/release/check-release-docs.mjs --version X.Y.Z                                   # 4e gate
 node scripts/release/check-cut-hygiene.mjs --version X.Y.Z                                    # 4g — post-bump proof

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

@@ -442,6 +442,16 @@ function step3PreFlight(args) {
     // moved every reference to the cut version, so validating at previous
     // false-fails gate 24 exactly like handoff would.
     const hygieneVersion = (args.mode === 'handoff' || args.resume) ? args.version : args.previous;
+    // A RESUMED run's versionArg gates (cut-hygiene) demand artifacts Step 4
+    // has not recreated yet — docs/releases/vX.Y.Z.md exists only after 4e,
+    // which runs AFTER this pre-flight. Step 4g re-runs these same gates at
+    // the cut version once the notes exist, so skipping them here loses no
+    // coverage — running them here false-fails by construction (the v0.8.32
+    // cut hit exactly this: 23/24 green, gate 24 dead on the missing notes).
+    if (g.versionArg && args.resume) {
+      console.log(`\n  ${g.n}/${GATE_ROSTER.length}. ${g.cmd}   # ${g.what} — [resume] deferred to Step 4g (notes not regenerated yet)`);
+      continue;
+    }
     const cmd = g.versionArg ? `${g.cmd} --version ${hygieneVersion}` : g.cmd;
     console.log(`\n  ${g.n}/${GATE_ROSTER.length}. ${cmd}   # ${g.what}`);
     try {
@@ -519,7 +529,30 @@ function step4PromoteAndBump(args) {
       sh(cmd, args);
     }
   } else {
-    console.log('  [resume] promote/stub already applied by the aborted run — skipping');
+    // The bump-complete marker proves promote+bump ran — it CANNOT see
+    // whether insert-stub ran: a stub package's [Unreleased] is empty, so
+    // the unpromoted guard below passes with the [X.Y.Z] section entirely
+    // absent, and the death arrives later at 4e's generate-release-notes
+    // ("no [X.Y.Z] CHANGELOG section in: …"). The v0.8.32 cut hit exactly
+    // this (the aborted run predated stub insertion). Complete the missing
+    // stubs here instead of skipping blindly — insert-stub hard-errors on
+    // existing sections, so filter to the genuinely missing ones.
+    if (args.stubPackages && args.substantive && args.xref) {
+      const missingStubs = args.stubPackages.filter((pkg) => {
+        const p = resolvePackageChangelog(REPO, pkg);
+        return fs.existsSync(p) && !fs.readFileSync(p, 'utf8').includes(`## [${args.version}]`);
+      });
+      if (missingStubs.length > 0) {
+        console.log(`  [resume] ${missingStubs.length} stub section(s) missing from the aborted run — completing: ${missingStubs.join(', ')}`);
+        sh(`node ${SCRIPT_DIR}/insert-stub.mjs --version ${args.version} --date ${args.date} --previous-version ${args.previous} --substantive "${args.substantive}" --xref "${args.xref}" --packages ${missingStubs.join(',')}`, args);
+      } else {
+        console.log('  [resume] promote/stub already applied by the aborted run — skipping');
+      }
+    } else {
+      console.log('  [resume] promote/stub already applied by the aborted run — skipping');
+      console.log('           (no --stub-packages/--substantive/--xref given; if 4e fails on');
+      console.log('           missing [X.Y.Z] sections, re-run with the stub flags to complete them)');
+    }
   }
 
   // Loud guard: after promotion, NO package in the lockstep set (including
@@ -636,8 +669,15 @@ function step5Commit(args) {
     `docs/releases/v${args.version}.md`,
     // gh#617: Step 4d.5 regenerates these post-bump (catalogId embeds the
     // lockstep version); unstaged, check:genui-catalog fails in CI (v0.8.26).
+    // catalog-data.js is the same derivation's third output (the browser-safe
+    // ES-module projection of base.json/adia-pack.json) — check-genui-catalog.mjs
+    // verifies its freshness too, but this list never carried it (found live
+    // during the v0.8.33 cut: base.json/adia-pack.json staged and committed
+    // fine, catalog-data.js sat modified-uncommitted, CI caught the drift a
+    // fresh checkout exposes that a local working tree doesn't).
     'packages/genui/adia-catalog/base.json',
     'packages/genui/adia-catalog/adia-pack.json',
+    'packages/genui/adia-catalog/catalog-data.js',
     ...PACKAGE_ROSTER.flatMap(({ name, dir, plugin }) => {
       // Roster-driven (H3): each package stages its manifest + CHANGELOG;
       // plugins also stage .claude-plugin/plugin.json (the /plugin-update
@@ -957,6 +997,24 @@ async function main() {
   // Fail-fast guard: refuse to git/npm/gh/curl against a non-monorepo directory.
   assertMonorepoRoot(REPO);
   console.log(`adia-release release-pack — v${args.version} (${args.mode})${args.dry ? ' [DRY]' : ''}`);
+  // Stale-plugin-cache self-check (v0.8.32 cut, first failure): the INSTALLED
+  // plugin cache only refreshes on a version bump, so running this script from
+  // the cache mid-cycle can execute a version that predates its own guards
+  // (SKILL.md §Plugin cache). If the repo carries its own copy and the bytes
+  // differ, warn loudly — the repo copy is almost always the newer one.
+  const repoCopy = path.join(REPO, 'packages/plugins/adia-ui-forge/skills/adia-release/scripts/release-pack.mjs');
+  const selfPath = new URL(import.meta.url).pathname;
+  if (fs.existsSync(repoCopy) && path.resolve(selfPath) !== path.resolve(repoCopy)) {
+    const self = fs.readFileSync(selfPath, 'utf8');
+    const repo = fs.readFileSync(repoCopy, 'utf8');
+    if (self !== repo) {
+      console.error('\n⚠  STALE-COPY WARNING: this release-pack.mjs differs from the repo\'s own copy at');
+      console.error(`   ${repoCopy}`);
+      console.error('   The installed plugin cache lags the repo between cuts (SKILL.md §Plugin cache);');
+      console.error('   the repo copy is almost certainly newer — prefer running it:');
+      console.error(`     node ${repoCopy} <same args>\n`);
+    }
+  }
   // gh#765: an aborted Step-4 run leaves bumped versions + promoted
   // CHANGELOGs; detect BEFORE pre-flight so gate 24 validates at the right
   // version and Step 4 skips the already-done promote/stub/bump.