feat(ai): agentic UI kit, docs, and Steps timeline polish

.github/workflows/ci.yml

@@ -15,13 +15,13 @@ on:
 
 concurrency:
   group: ci-${{ github.ref }}
-  cancel-in-progress: true
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
 
 permissions:
   contents: read
 
 jobs:
-  registry:
+  quality:
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
@@ -42,15 +42,10 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Build shadcn registry
-        run: pnpm build:registry
-
-      - name: Verify migration registry installs
-        env:
-          SMOKE_CASE: org-chart,storage-browser,sheets,schema-builder,command-palette
-        run: pnpm --filter @constructive-io/registry smoke:install
+      - name: Check types and tests
+        run: pnpm check
 
-  packages:
+  delivery:
     runs-on: ubuntu-latest
     timeout-minutes: 30
     steps:
@@ -74,30 +69,41 @@ jobs:
       - name: Verify packed packages in clean consumers
         run: pnpm pack:check
 
-  pages:
-    needs: packages
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v7
-        with:
-          persist-credentials: false
+      - name: Build shadcn registry
+        run: pnpm build:registry
 
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v6
+      - name: Verify representative registry installs
+        env:
+          SMOKE_CASE: ai,schema-builder,command-palette
+          SMOKE_REUSE_PACKED_ARTIFACTS: '1'
+        run: pnpm --filter @constructive-io/registry smoke:install
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v7
-        with:
-          node-version: '24'
-          cache: pnpm
+      - name: Build static Blocks site
+        run: pnpm --filter blocks build:pages
 
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
+      - name: Assemble Pages artifact
+        run: pnpm pages:artifact
 
-      - name: Build Pages artifact
-        run: pnpm build:pages
+      - name: Upload Pages artifact
+        if: github.ref == 'refs/heads/main' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: .artifacts/pages
+
+  deploy:
+    if: github.ref == 'refs/heads/main' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
+    needs: [quality, delivery]
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5
 
-# npm releases are intentionally manual. Package tags build the registry and
-# Pages artifact only; this workflow contains no publish credentials or job.
+# Package tags validate publishable tarballs and Pages inputs, but npm
+# publication remains a manual maintainer action.

apps/blocks/README.md

@@ -20,8 +20,7 @@ pnpm --filter blocks build:pages
 
 `src/lib/base-primitives.ts`, `src/lib/billing-blocks.ts`, and
 `src/lib/feature-packs.ts` are the documentation catalogs. `pnpm gen:check`
-validates primitive distribution and keeps the feature-pack docs aligned with
-their manifests, registry roots, and live previews.
+regenerates (or checks) generated UI demo source used by the docs app.
 
 From the repository root,
 `pnpm --silent console-kit:inspect --item <registry-root>`

apps/blocks/next.config.ts

@@ -18,7 +18,9 @@ const nextConfig: NextConfig = {
     : {}),
   transpilePackages: ['@constructive-io/ui'],
   experimental: {
-    optimizePackageImports: ['@base-ui/react', '@constructive-io/ui', 'lucide-react'],
+    // Do not include @constructive-io/ui: subpath exports like /ai, /tabs, /button
+    // break under optimizePackageImports (client components resolve to undefined → blank page).
+    optimizePackageImports: ['@base-ui/react', 'lucide-react'],
   },
   turbopack: {
     root: path.join(__dirname, '..', '..'),

apps/blocks/package.json

@@ -3,20 +3,18 @@
   "version": "0.0.0",
   "private": true,
   "scripts": {
-    "gen": "tsx scripts/generate-ui-demo-source.ts && tsx scripts/check-docs.ts",
-    "gen:check": "tsx scripts/generate-ui-demo-source.ts --check && tsx scripts/check-docs.ts",
-    "build:registry": "pnpm --filter @constructive-io/registry build",
-    "check:flows": "pnpm gen:check",
-    "check:install-namespace": "pnpm gen:check",
+    "gen": "tsx scripts/generate-ui-demo-source.ts",
+    "gen:check": "tsx scripts/generate-ui-demo-source.ts --check",
+    "build:registry": "pnpm --workspace-root build:registry",
+    "check:generated": "pnpm gen:check",
     "check:selections": "tsx scripts/check-mutation-selections.ts",
     "predev": "pnpm gen:check",
     "prebuild": "pnpm gen:check",
     "dev": "next dev --turbopack --port 3005",
     "build": "next build",
     "build:pages": "BLOCKS_PAGES=1 next build",
     "start": "next start --port 3005",
-    "lint:types": "tsc --noEmit && pnpm scripts:typecheck",
-    "scripts:typecheck": "tsc --noEmit -p tsconfig.scripts.json",
+    "lint:types": "tsc --noEmit",
     "test": "vitest run && pnpm test:native-fixture",
     "test:native-fixture": "tsx --test e2e-live/native-fixture.test.ts",
     "test:watch": "vitest --watch",