Merge pull request #852 from objectstack-ai/copilot/upgrade-objectstack-to-latest-yet-again

Author: hotlong

ROADMAP.md

@@ -1,9 +1,9 @@
 # ObjectUI Development Roadmap
 
-> **Last Updated:** February 24, 2026
+> **Last Updated:** February 25, 2026
 > **Current Version:** v0.5.x
-> **Spec Version:** @objectstack/spec v3.0.9
-> **Client Version:** @objectstack/client v3.0.9
+> **Spec Version:** @objectstack/spec v3.0.10
+> **Client Version:** @objectstack/client v3.0.10
 > **Target UX Benchmark:** 🎯 Airtable parity
 > **Current Priority:** AppShell Navigation · Designer Interaction · View Config Live Preview Sync · Dashboard Config Panel · Airtable UX Polish · **Flow Designer ✅** · **App Creation & Editing Flow ✅** · **System Settings & App Management ✅** · **Right-Side Visual Editor Drawer ✅**
 
@@ -49,6 +49,28 @@ ObjectUI is a universal Server-Driven UI (SDUI) engine built on React + Tailwind
 
 ---
 
+## 🔄 Spec v3.0.10 Upgrade Summary
+
+> Upgraded from `@objectstack/spec v3.0.9` → `v3.0.10` on February 25, 2026. UI sub-export adds new Zod schemas and `ViewFilterRule` type. Dashboard widgets now require `id` field. View filters must use object format.
+
+**New Protocol Capabilities (v3.0.10):**
+
+| Area | What's New | Impact on ObjectUI |
+|------|------------|-------------------|
+| **UI Schemas** | `DensityModeSchema`, `ThemeModeSchema`, `WcagContrastLevelSchema` Zod schemas | Re-exported from `@object-ui/types` for runtime validation |
+| **View Filter Rules** | `ViewFilterRule`, `ViewFilterRuleSchema` — structured filter format `{ field, operator, value }` | All view filters migrated from tuple `['field', '=', 'value']` to object format |
+| **Dashboard Widgets** | `id` field now required on `DashboardWidgetSchema` | All example dashboard widgets updated with explicit `id` |
+| **Filter AST** | `isFilterAST`, `parseFilterAST`, `VALID_AST_OPERATORS` in data sub-export | Filter engine utilities (P2.4) |
+| **Multi-Tenant** | `TursoMultiTenantConfig`, `TenantResolverStrategy`, `TenantDatabaseLifecycle` | Cloud multi-tenancy (P2.4) |
+| **Contracts** | `IAppLifecycleService`, `IDeployPipelineService`, `IProvisioningService`, `ITenantRouter`, `ISchemaDiffService` | Cloud deployment & lifecycle (P2.4) |
+
+**Breaking Changes Applied:**
+- All CRM view filters converted from `['field', '=', 'value']` to `[{ field, operator: '=', value }]`
+- All dashboard widgets (kitchen-sink, todo, CRM) given explicit `id` fields
+- Todo active filter converted from `[['status', '!=', 'Done']]` to `[{ field: 'status', operator: '!=', value: 'Done' }]`
+
+---
+
 ## 🎯 P0 — Must Ship (v1.0 Blockers)
 
 ### P0.1 AppShell & Navigation Renderer

apps/console/package.json

@@ -63,13 +63,13 @@
     "@object-ui/plugin-view": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
-    "@objectstack/cli": "^3.0.9",
-    "@objectstack/client": "^3.0.9",
-    "@objectstack/driver-memory": "^3.0.9",
-    "@objectstack/objectql": "^3.0.9",
-    "@objectstack/plugin-msw": "^3.0.9",
-    "@objectstack/runtime": "^3.0.9",
-    "@objectstack/spec": "^3.0.9",
+    "@objectstack/cli": "^3.0.10",
+    "@objectstack/client": "^3.0.10",
+    "@objectstack/driver-memory": "^3.0.10",
+    "@objectstack/objectql": "^3.0.10",
+    "@objectstack/plugin-msw": "^3.0.10",
+    "@objectstack/runtime": "^3.0.10",
+    "@objectstack/spec": "^3.0.10",
     "@tailwindcss/postcss": "^4.1.18",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",

examples/crm/package.json

@@ -19,19 +19,19 @@
   },
   "dependencies": {
     "@hono/node-server": "^1.19.9",
-    "@objectstack/core": "^3.0.9",
-    "@objectstack/driver-memory": "^3.0.9",
-    "@objectstack/objectql": "^3.0.9",
-    "@objectstack/plugin-auth": "^3.0.9",
-    "@objectstack/plugin-hono-server": "^3.0.9",
-    "@objectstack/runtime": "^3.0.9",
-    "@objectstack/spec": "^3.0.9",
+    "@objectstack/core": "^3.0.10",
+    "@objectstack/driver-memory": "^3.0.10",
+    "@objectstack/objectql": "^3.0.10",
+    "@objectstack/plugin-auth": "^3.0.10",
+    "@objectstack/plugin-hono-server": "^3.0.10",
+    "@objectstack/runtime": "^3.0.10",
+    "@objectstack/spec": "^3.0.10",
     "hono": "^4.12.2",
     "pino": "^8.21.0",
     "pino-pretty": "^13.1.3"
   },
   "devDependencies": {
-    "@objectstack/cli": "^3.0.9",
+    "@objectstack/cli": "^3.0.10",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }

examples/crm/src/dashboards/crm.dashboard.ts

@@ -5,6 +5,7 @@ export const CrmDashboard = {
   widgets: [
     // --- KPI Row ---
     {
+      id: 'total_revenue',
       title: 'Total Revenue',
       type: 'metric' as const,
       object: 'opportunity',
@@ -17,6 +18,7 @@ export const CrmDashboard = {
       }
     },
     {
+      id: 'active_deals',
       title: 'Active Deals',
       type: 'metric' as const,
       object: 'opportunity',
@@ -29,6 +31,7 @@ export const CrmDashboard = {
       }
     },
     {
+      id: 'win_rate',
       title: 'Win Rate',
       type: 'metric' as const,
       object: 'opportunity',
@@ -41,6 +44,7 @@ export const CrmDashboard = {
       }
     },
     {
+      id: 'avg_deal_size',
       title: 'Avg Deal Size',
       type: 'metric' as const,
       object: 'opportunity',
@@ -55,6 +59,7 @@ export const CrmDashboard = {
 
     // --- Row 2: Charts (provider: 'object' — dynamic aggregation) ---
     {
+        id: 'revenue_trends',
         title: 'Revenue Trends',
         type: 'area' as const,
         object: 'opportunity',
@@ -73,6 +78,7 @@ export const CrmDashboard = {
         },
     },
     {
+        id: 'lead_source',
         title: 'Lead Source',
         type: 'donut' as const,
         object: 'opportunity',
@@ -93,6 +99,7 @@ export const CrmDashboard = {
 
     // --- Row 3: More Charts (provider: 'object' — dynamic aggregation) ---
     {
+        id: 'pipeline_by_stage',
         title: 'Pipeline by Stage',
         type: 'bar' as const,
         object: 'opportunity',
@@ -111,6 +118,7 @@ export const CrmDashboard = {
         },
     },
     {
+        id: 'top_products',
         title: 'Top Products',
         type: 'bar' as const,
         object: 'product',
@@ -131,6 +139,7 @@ export const CrmDashboard = {
 
     // --- Row 4: Table (provider: 'object' — dynamic data) ---
     {
+        id: 'recent_opportunities',
         title: 'Recent Opportunities',
         type: 'table' as const,
         object: 'opportunity',
@@ -151,6 +160,7 @@ export const CrmDashboard = {
 
     // --- Row 5: Dynamic KPI from Object Data ---
     {
+        id: 'revenue_by_account',
         title: 'Revenue by Account',
         type: 'bar' as const,
         object: 'opportunity',
@@ -171,6 +181,7 @@ export const CrmDashboard = {
 
     // --- Row 6: Additional aggregate functions (avg, max) + cross-object ---
     {
+        id: 'avg_deal_by_stage',
         title: 'Avg Deal Size by Stage',
         type: 'line' as const,
         object: 'opportunity',
@@ -189,6 +200,7 @@ export const CrmDashboard = {
         },
     },
     {
+        id: 'orders_by_status',
         title: 'Orders by Status',
         type: 'bar' as const,
         object: 'order',

examples/crm/src/views/account.view.ts

@@ -14,7 +14,7 @@ export const AccountView = {
       type: 'grid' as const,
       data: { provider: 'object' as const, object: 'account' },
       columns: ['name', 'industry', 'annual_revenue', 'phone', 'owner'],
-      filter: ['type', '=', 'Customer'],
+      filter: [{ field: 'type', operator: '=', value: 'Customer' }],
       sort: [{ field: 'annual_revenue', order: 'desc' as const }],
     },
   },

examples/crm/src/views/contact.view.ts

@@ -14,7 +14,7 @@ export const ContactView = {
       type: 'grid' as const,
       data: { provider: 'object' as const, object: 'contact' },
       columns: ['name', 'email', 'title', 'account', 'status'],
-      filter: ['is_active', '=', true],
+      filter: [{ field: 'is_active', operator: '=', value: true }],
     },
   },
   form: {

examples/crm/src/views/event.view.ts

@@ -26,7 +26,7 @@ export const EventView = {
       type: 'grid' as const,
       data: { provider: 'object' as const, object: 'event' },
       columns: ['subject', 'start', 'location', 'organizer'],
-      filter: ['type', '=', 'meeting'],
+      filter: [{ field: 'type', operator: '=', value: 'meeting' }],
       sort: [{ field: 'start', order: 'asc' as const }],
     },
   },

examples/crm/src/views/order.view.ts

@@ -14,7 +14,7 @@ export const OrderView = {
       type: 'grid' as const,
       data: { provider: 'object' as const, object: 'order' },
       columns: ['name', 'customer', 'amount', 'order_date'],
-      filter: ['status', '=', 'pending'],
+      filter: [{ field: 'status', operator: '=', value: 'pending' }],
     },
   },
   form: {

examples/crm/src/views/product.view.ts

@@ -39,7 +39,7 @@ export const ProductView = {
         { field: 'stock', label: 'STOCK', type: 'number' as const, width: 80, align: 'right' as const },
         { field: 'tags', label: 'TAGS', type: 'select' as const, width: 130 },
       ],
-      filter: ['is_active', '=', true],
+      filter: [{ field: 'is_active', operator: '=', value: true }],
       rowHeight: 'short' as const,
     },
   },

examples/crm/src/views/user.view.ts

@@ -14,7 +14,7 @@ export const UserView = {
       type: 'grid' as const,
       data: { provider: 'object' as const, object: 'user' },
       columns: ['name', 'email', 'role', 'title'],
-      filter: ['active', '=', true],
+      filter: [{ field: 'active', operator: '=', value: true }],
     },
   },
   form: {