@adia-ai/adia-ui-factory 0.8.46 → 0.8.48

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-ui-kit-factory",
-  "version": "0.8.46",
+  "version": "0.8.48",
   "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.48",
+  "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.46", "gen-ui"]
+      "args": ["-y", "@adia-ai/mcp@0.8.48", "gen-ui"]
     }
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — adia-ui-kit-factory
 
+## [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
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the lockstep version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.8.47 work shipped in table-toolbar size/chrome fixes, anchor popover reuse guard, token-layer light-dark cleanup (gh#1852), side-by-side docs demos. See `packages/web-components/CHANGELOG.md#0847--2026-08-22` for details.
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+
 ## [0.8.46] — 2026-08-22
 
 

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.46` (tool SoT:
+`adia-gen-ui` server pinned: `@adia-ai/mcp@0.8.48` (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.46",
-  "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.48",
+  "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/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/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/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/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/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."