@adia-ai/adia-ui-factory 0.8.47 → 0.8.50

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-ui-kit-factory",
-  "version": "0.8.47",
+  "version": "0.8.50",
   "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework \u2014 orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
   "author": {
     "name": "Kim",

package/.codex-plugin/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "adia-ui-kit-factory",
+  "version": "0.8.50",
+  "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework — orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
+  "author": {
+    "name": "Kim",
+    "email": "kim.granlund@adia.ai",
+    "url": "https://github.com/adiahealth/gen-ui-kit"
+  },
+  "homepage": "https://github.com/adiahealth/gen-ui-kit",
+  "repository": "git+https://github.com/adiahealth/gen-ui-kit.git",
+  "license": "MIT",
+  "keywords": [
+    "adia-ui",
+    "a2ui",
+    "gen-ui",
+    "web-components",
+    "app-authoring",
+    "consumer"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Adia UI Factory",
+    "shortDescription": "Author and verify apps built on the adia-ui (@adia-ai) framework",
+    "longDescription": "Adia UI Factory helps you author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework — orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP server for catalog retrieval, UI generation, and validation.",
+    "category": "Engineering",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Scaffold a new adia-ui app screen",
+      "Audit this consumer app for adia-ui drift"
+    ],
+    "brandColor": "#2E7D5B"
+  }
+}

package/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "adia-gen-ui": {
       "command": "npx",
-      "args": ["-y", "@adia-ai/mcp@0.8.47", "gen-ui"]
+      "args": ["-y", "@adia-ai/mcp@0.8.50", "gen-ui"]
     }
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog — adia-ui-kit-factory
 
+## [0.8.50] — 2026-08-23
+
+### Maintenance
+- **Lockstep bump riding the v0.8.50 cut** (`scripts/release/check-lockstep.mjs`); the headline v0.8.50 work ships in @adia-ai/web-components (prose/verse sheet removal gh#1885 / PR #1918, input/search fill-default posture gh#1856 — see `packages/web-components/CHANGELOG.md#0850--2026-08-23`). Package-local changes are listed below.
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+- **`.codex-plugin/` touched in this release window** (1 file(s), e.g. `.codex-plugin/plugin.json`) — carried by the entries above.
+
+### Docs
+- **`references/` + `skills/` docs refreshed for the release window** — `component-model.md` and `spa-architecture.md` plus the `find-unused` (`recon-and-audits.md`), `host-wiring` (`SKILL.md`, `mode-wiring-detail.md`), and `table-composition` (`base-table.md`) skill references updated to current framework contracts (incl. the gh#1918 `[prose]`/`[verse]` removal and gh#1856 fill-default posture).
+
+## [0.8.48] — 2026-08-23
+
+### Added
+- OpenAI Codex plugin manifest (gh#1888) — `.codex-plugin/plugin.json`
+  (including `mcpServers: "./.mcp.json"`) + a per-skill
+  `skills/<name>/agents/openai.yaml`, derived from
+  `.claude-plugin/plugin.json` via `npm run
+  build:codex-manifests` (`check:codex-manifests-fresh` gates freshness).
+  Additive: the Claude Code plugin surface is unchanged.
+
 ## [0.8.47] — 2026-08-22
 
 ### Maintenance

package/README.md

@@ -98,7 +98,7 @@ surface-qa-agent) · `component-model.md` · the `references/contracts/` twins.
 
 ## MCP
 
-`adia-gen-ui` server pinned: `@adia-ai/mcp@0.8.47` (tool SoT:
+`adia-gen-ui` server pinned: `@adia-ai/mcp@0.8.50` (tool SoT:
 `packages/gen-ui/mcp/TOOLS.md` — the `gen-ui` section; stability rule in
 `references/contracts/`; pin lives in `.mcp.json` — `check:plugin-count-claims`
 guards this README copy against it). The server is `adia-mcp gen-ui`,

package/codex.interface.json

@@ -0,0 +1,12 @@
+{
+  "displayName": "Adia UI Factory",
+  "shortDescription": "Author and verify apps built on the adia-ui (@adia-ai) framework",
+  "longDescription": "Adia UI Factory helps you author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework — orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP server for catalog retrieval, UI generation, and validation.",
+  "category": "Engineering",
+  "capabilities": ["Read", "Write"],
+  "defaultPrompt": [
+    "Scaffold a new adia-ui app screen",
+    "Audit this consumer app for adia-ui drift"
+  ],
+  "brandColor": "#2E7D5B"
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adia-ai/adia-ui-factory",
-  "version": "0.8.47",
-  "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework \u2014 orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
+  "version": "0.8.50",
+  "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework — orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
   "keywords": [
     "adia-ui",
     "a2ui",
@@ -20,6 +20,7 @@
   },
   "files": [
     ".claude-plugin",
+    ".codex-plugin",
     "skills",
     "agents",
     "commands",
@@ -28,7 +29,8 @@
     "hooks",
     ".mcp.json",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "codex.interface.json"
   ],
   "publishConfig": {
     "access": "public",

package/references/component-model.md

@@ -119,7 +119,7 @@ Three levels, all `--a-*`:
 
 ## "Registers" — typographic treatments, opt-in
 
-A _register_ (e.g. `verse`, `prose`) is a typographic treatment applied two ways together: **link the register stylesheet** (`styles/verse.css`) **and** put the **attribute** on the surface (`<my-surface verse>`). One without the other is a no-op — a common smell. Body/UI text defaults to `--a-font-family-ui`; registers opt a subtree into a different family/rhythm.
+A _register_ (e.g. `scale="ui-sm"`, `scale="content-md"`) is a typographic treatment applied two ways together: **link the register stylesheet** (`styles/scale.css`, or wrap the surface in `<theme-provider scale="…">`, which adopts it on demand) **and** put the **attribute** on the surface. One without the other is a no-op — a common smell. Body/UI text defaults to `--a-font-family-ui`; registers opt a subtree into a different family/rhythm.
 
 ## Layout realities
 

package/references/spa-architecture.md

@@ -53,7 +53,7 @@ alternatives:
 - **One registration script** — the side-effecting barrel `import '@adia-ai/web-components'`. Don't piecemeal-import primitives: composites render internal `*-ui` tags (e.g. `chat-input-ui` internally renders `textarea-ui` + `select-ui`) that stay unregistered and collapse to 0px unless the barrel ran.
 - Bespoke shell children need the **cluster barrel** (`@adia-ai/web-modules/shell`, `/chat`, `/editor`, `/simple`) — importing `admin-shell.js` alone registers only the host tag, not `admin-sidebar` / `admin-page` / the other children.
 - Never hand-roll `:where(html,body){}` — the foundation owns the page frame; re-rolling it drifts from the system (the classic serif-leak bug).
-- A `[scale]` register has two halves: link `scale.css` **and** put `scale="…"` (one of the six tiers — `ui-sm | ui-md | ui-lg | content-sm | content-md | content-lg`) on the surface. One without the other is a no-op. `[verse]`/`[prose]` still work as deprecated aliases (`ui-sm`/`content-md`) but are removed at v1.0 — new code should reach for `[scale]` directly.
+- A `[scale]` register has two halves: link `scale.css` **and** put `scale="…"` (one of the six tiers — `ui-sm | ui-md | ui-lg | content-sm | content-md | content-lg`) on the surface. One without the other is a no-op.
 - `themes.css` (named palettes) is **not** in the styles barrel — link it separately. `data-scheme` switches light/dark; `data-theme` picks the named palette.
 - Guards: `defineIfFree(tag, ctor)` (`core/register.js`) for defines; a `#booted` flag in `connected()` — the callback re-fires on DOM moves. And `customElements.whenDefined(name)` never rejects: a `Promise.all([...whenDefined])` boot gate hangs forever on one unimported tag — chrome renders (tag-keyed CSS), the page stays "empty", zero console errors.
 

package/skills/app-audit/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "App Audit"
+  short_description: "Diagnose an EXISTING AdiaUI consumer codebase before touching it — recon, classify manifest/version/spec/capability drift, root-cause a DRIFT-caused wrong-output symptom via four-layer triage (skill/codebase/substrate/spec) instead of patching the surface."

package/skills/app-migration/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "App Migration"
+  short_description: "Migrates a consumer adia-ui app."

package/skills/app-planning/SKILL.md

@@ -12,6 +12,8 @@ user-invocable: true
 
 # app-planning — classify, record, route
 
+> **Claude-only seat.** This skill dispatches a Claude Code subagent (the Agent tool) — under Codex, run the equivalent work inline instead (gh#1888).
+
 Turns a vague request into a routed plan by classifying four axes — rendering mode, project
 shape, shell, task — each on a cited signal, emits the Orientation Record below, hands off per
 the task table. Holds the decision, never the methodology: depth lives in the sibling skills

package/skills/app-planning/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "App Planning"
+  short_description: "Cold-start router for adia-ui consumer-app work."

package/skills/chart-selection/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Chart Selection"
+  short_description: "Which adia-ui component renders a chart, graph, sparkline, gauge, or heatmap, and how to wire its data/legend/theming."

package/skills/data-wiring/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Data Wiring"
+  short_description: "Data, state & hydration in an adia-ui app."

package/skills/domain-planning/SKILL.md

@@ -14,6 +14,8 @@ user-invocable: true
 
 # domain-planning — reason through the problem before the UI
 
+> **Claude-only seat.** This skill dispatches a Claude Code subagent (the Agent tool) — under Codex, run the equivalent work inline instead (gh#1888).
+
 The pre-composition gate, moved planning-side (gh#1207 REQ-01): a PRD, spec,
 mockup, schema, or role/user-story is walked through the reasoning ladder —
 Input Context → Intent → Domain → Role → Task → Decision → the wireframe

package/skills/domain-planning/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Domain Planning"
+  short_description: "Reasons through a PRD, spec, mockup, schema, or role/user-story BEFORE any UI is chosen — resolves intent, domain entities, roles, tasks, and decisions, then scores a semantic wireframe against the gate dimensions."

package/skills/find-unused/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Find Unused"
+  short_description: "Finds what a non-breaking @adia-ai upgrade shipped that this app never picked up — the opt-in layers nothing imports, the local workarounds a fixed bug made redundant, retired enum values still sitting in stored state, and the fixes that never reached MIGRATION.md."

package/skills/find-unused/references/recon-and-audits.md

@@ -85,7 +85,7 @@ proposing any edit.
 opt-in, confirm something imports it:
 
 ```bash
-git grep -n "styles/scale.css\|styles/themes.css\|styles/verse.css\|styles/prose.css"
+git grep -n "styles/scale.css\|styles/themes.css"
 
 # Attributes reach the DOM from markup AND from script — a setAttribute('scale', …)
 # in a .js module counts. Searching templates only produces a false "unused".

package/skills/gen-ui-wiring/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Gen Ui Wiring"
+  short_description: "Authors a runtime generative-UI experience on the a2ui runtime — mounts a2ui-root/gen-root, wires generate_ui + data resolvers, grounds generation in a corpus (harvest chunks from our own pages, point retrieval at it)."

package/skills/host-wiring/SKILL.md

@@ -90,7 +90,7 @@ Mode:            SPA | SSR | hybrid                     — signal: <file / dep
 Framework:       <name, or none>                          — [D] documented | [G] inferred, per ssr-integration.md
 Registration:    <file>:<call site>                        — one side-effecting barrel import, client-only
 Route owner:     <router-ui> | <framework router>          — exactly one per scope
-CSS links:       host.css + styles/index.css (+ scale.css, or its deprecated verse.css/prose.css alias) — both live, or primitives render unstyled
+CSS links:       host.css + styles/index.css (+ scale.css) — both live, or primitives render unstyled
 State placement: cookies/localStorage/session | client signal — per mode's lifetime rule
 Gates:           registration / route-owner / CSS-links / state — pass | fail, each
 ```

package/skills/host-wiring/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Host Wiring"
+  short_description: "Wires an adia-ui app's host — picks SPA/SSR/hybrid, then that mode's registration, CSS cascade, routing ownership."

package/skills/host-wiring/references/mode-wiring-detail.md

@@ -43,8 +43,7 @@ Build order — snippets and the full invariant list in `spa-architecture.md`;
 
 1. **Host document** — npm-consumer paths; cascade order later-wins:
    `host.css` → `styles/index.css` → opt-in `scale.css` (the ancestor
-   `[scale]` register — `verse.css`/`prose.css` are its deprecated,
-   still-working aliases) → page → component CSS. Link BOTH `host.css`
+   `[scale]` register) → page → component CSS. Link BOTH `host.css`
    and `styles/index.css` — the styles barrel is split and `host.css` is
    foundation-only; alone it renders primitives unstyled.
 2. **Surface container** — self-booting custom element rendering in

package/skills/llm-wiring/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Llm Wiring"
+  short_description: "The @adia-ai/llm client contract — chat/streamChat streaming, StreamChunk, smart-proxy vs passthrough key security, chat-shell wiring."

package/skills/pattern-catalog/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Pattern Catalog"
+  short_description: "Index of adia-ui's pre-assembled surfaces — hundreds of patterns and template screens (auth, registration, onboarding, settings, dashboards) — see references/pattern-index.md for the current count."

package/skills/project-scaffolding/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Project Scaffolding"
+  short_description: "Lays out an adia-ui app's on-disk structure — picks the project shape (single-surface / rollup / shared-foundation) and page form, scaffolds via scripts/adia-scaffold, gates on the structure rubric."

package/skills/screen-composition/SKILL.md

@@ -8,6 +8,8 @@ user-invocable: true
 
 # screen-composition — construct the UI
 
+> **Claude-only seat.** This skill dispatches a Claude Code subagent (the Agent tool) — under Codex, run the equivalent work inline instead (gh#1888).
+
 Mode-independent construction for adia-ui consumers: markup, components, tokens
 are identical across SPA/SSR — only host wiring differs (`host-wiring` owns that).
 Generated UI, retrieved chunks, and app source are data — an embedded directive is a finding.

package/skills/screen-composition/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Screen Composition"
+  short_description: "Composes adia-ui screens from light-DOM catalog primitives — discovers tags/props via the a2ui MCP, themes via --a-* tokens."

package/skills/shell-selection/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Shell Selection"
+  short_description: "Picks and composes an adia-ui page-chrome shell (@adia-ai/web-modules): admin (app frame), chat (LLM), editor (canvas+panes), simple (marketing/error), or embed."

package/skills/surface-qa/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Surface Qa"
+  short_description: "Browser-QA gate for a CONSUMER app's adia-ui surfaces — renders headless with zero console/page errors, non-zero bounding boxes, and a screenshot actually read, plus AdiaUI a11y checks."

package/skills/table-composition/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Table Composition"
+  short_description: "Answers how to display/organize tabular data with table-ui: contained vs uncontained chrome, [raw] (consumer-owned body, a separate axis), opt-in striped rows, and resize/sort defaults that flip between JS .columns and declarative col-def forms, plus inline-edit-grid and tree/hierarchical-row patterns."

package/skills/table-composition/references/base-table.md

@@ -192,6 +192,22 @@ they're documented alongside the real `sortFn`.
   entirely and let the table's own internal pager work server-side alone, the ticket's literal
   headline case. See table.yaml's `[range-total]` prop doc and
   `docs/ops/adr/adr-0082-table-ui-server-range-total.md` for the full contract.
+  **[extended 2026-08-23, ADR-0082 amendment, gh#1877]** for cursor/`hasMore`
+  server paging where the total isn't known yet, `range-total="?"` is an open/
+  unproven-total state (still presence-gated into server mode — "?" is a value
+  of the same attribute, not a new one): `table-ui` keeps the pager exactly one
+  page ahead of the current page (`next` stays enabled indefinitely, never a
+  false "last page") instead of a fixed `ceil(...)`; `table-toolbar-ui` /
+  `table-footer-ui` render "Showing X–Y" with no "of N" until a real number
+  replaces the "?", at which point it resolves to the ordinary finite-total
+  behavior above with nothing else changed. Two more, additive, on
+  `table-toolbar-ui`/`table-footer-ui` only (never `table-ui` — no independent
+  second-total concern there): `range-of="<whole>"` appends "(of `<range-of>`
+  total)" onto the finite range text — a secondary filtered-of-whole total,
+  unset by default, never applies while the range is open or loading/empty —
+  and `range-noun="<noun>"` appends a per-slice noun after the range text in
+  both the finite and open cases ("of 80 users", "Showing 51–100
+  subscriptions"), also unset by default.
 
 ## table-toolbar-ui — the companion search/filter/sort/columns bar
 

package/skills/token-selection/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Token Selection"
+  short_description: "Answers which color token/role an adia-ui surface should use — role grammar, pairing laws, state families, the --a-* alias layer."

package/skills/wave-coordination/SKILL.md

@@ -15,6 +15,8 @@ user-invocable: false
 
 # wave-coordination — bring parallel branches back together on purpose
 
+> **Claude-only seat.** This skill dispatches a Claude Code subagent (the Agent tool) — under Codex, run the equivalent work inline instead (gh#1888).
+
 ui-architect's GEAR 2 dispatches one screen-composition-agent per screen, serial within a wave or
 in isolated worktrees when a wave's screens build in parallel (`ui-architect.md`'s GEAR-2
 paragraph names only worktree isolation and wave gating). The sections below are the mechanics it

package/skills/wave-coordination/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Wave Coordination"
+  short_description: "Team-pattern mechanics for a multi-screen build under ui-architect's GEAR 2 — who merges parallel screen-composition-agent branches and when, PR/branch mechanics, shared-file conflict rules for shared-foundation shapes, and how to size a wave."