Skip to content

Commit b3bf228

Browse files
hotlonghotlong
authored
Merge pull request #49 from objectstack-ai/copilot/update-objectstack-to-latest
2 parents 264c342 + 59c7be2 commit b3bf228

3 files changed

Lines changed: 151 additions & 77 deletions

File tree

‎ROADMAP.md‎

Lines changed: 87 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# ObjectStack Mobile — Roadmap
22

3-
> **Date**: 2026-02-13
4-
> **SDK**: `@objectstack/client@3.0.0`, `@objectstack/client-react@3.0.0`, `@objectstack/spec@3.0.0`
3+
> **Date**: 2026-02-22
4+
> **SDK**: `@objectstack/client@3.0.9`, `@objectstack/client-react@3.0.9`, `@objectstack/spec@3.0.9`
55
> **Tests**: ✅ 1003/1003 passing (127 suites, ~85% coverage)
66
77
---
88

99
## 1. Project Status
1010

11-
The ObjectStack Mobile client has completed all core development phases (0–6), spec alignment phases (9–10), advanced feature phases (11–13), UX/platform phases (14–20), spec gap phases (21–22), and post-GA features (v1.4–v1.6). The SDK is upgraded to v3.0.0 (spec v3.0.0: 12 modules, 171 schemas).
11+
The ObjectStack Mobile client has completed all core development phases (0–6), spec alignment phases (9–10), advanced feature phases (11–13), UX/platform phases (14–20), spec gap phases (21–22), and post-GA features (v1.4–v1.6). The SDK is upgraded to v3.0.9 (spec v3.0.9: 14 modules, 1683 JSON schemas, 8,380+ `.describe()` annotations).
1212

1313
### What's Implemented
1414

@@ -29,7 +29,7 @@ The ObjectStack Mobile client has completed all core development phases (0–6),
2929
| Runtime | Expo SDK 54, TypeScript 5.9 strict |
3030
| Navigation | Expo Router (file-based) |
3131
| Styling | NativeWind v4 (Tailwind CSS) |
32-
| Client SDK | `@objectstack/client@3.0.0` + `@objectstack/client-react@3.0.0` |
32+
| Client SDK | `@objectstack/client@3.0.9` + `@objectstack/client-react@3.0.9` |
3333
| State | Zustand + TanStack Query v5 |
3434
| Offline | expo-sqlite + sync queue |
3535
| Auth | better-auth v1.4.18 + `@better-auth/expo` |
@@ -148,11 +148,11 @@ The ObjectStack Mobile client has completed all core development phases (0–6),
148148

149149
---
150150

151-
## 3. Spec v3.0.0 Compliance Matrix
151+
## 3. Spec v3.0.9 Compliance Matrix
152152

153-
> `@objectstack/spec` is the protocol "constitution". v3.0.0 restructured from 15 → 12 modules.
154-
> Removed: `driver`, `auth`, `hub`, `permission`. Added: `security` (RLS, Policy, Sharing, Territory).
155-
> Total: 171 Zod schemas, 7,095+ `.describe()` annotations.
153+
> `@objectstack/spec` is the protocol "constitution". v3.0.9 has 14 modules, 1683 JSON schemas, 8,380+ `.describe()` annotations.
154+
> Modules: `ai`, `api`, `automation`, `cloud`, `data`, `identity`, `integration`, `kernel`, `qa`, `security`, `shared`, `studio`, `system`, `ui`.
155+
> v3.0.0 restructured from 15 → 12 modules. v3.0.9 expanded to 14 modules (added `studio`, `qa`, `cloud`, `kernel`).
156156
157157
### ✅ Fully Implemented
158158

@@ -212,9 +212,21 @@ The ObjectStack Mobile client has completed all core development phases (0–6),
212212
| `spec/automation` — ETL Pipelines | `useETLPipeline` |
213213
| `spec/integration` — Connectors | `useConnector` |
214214

215-
### ✅ No Remaining Spec Gaps
215+
### 🟡 New in Spec v3.0.9 — UI Protocol Schemas (Pending Implementation)
216216

217-
All spec modules have been implemented, including previously deferred AI DevOps/CodeGen/Predictive and ETL/Connector features.
217+
The following new UI protocol schemas were added in spec v3.0.9 and are candidates for future mobile implementation:
218+
219+
| Category | Spec Schemas | Mobile Status |
220+
|----------|-------------|---------------|
221+
| Record Page Components | `RecordDetailsProps`, `RecordActivityProps`, `RecordChatterProps`, `RecordHighlightsProps`, `RecordPathProps`, `RecordRelatedListProps`, `RecordReviewConfigSchema` | 🟡 Partial — detail tabs exist, SDUI record pages pending |
222+
| Drag & Drop Protocol | `DndConfigSchema`, `DragItemSchema`, `DragHandleSchema`, `DragConstraintSchema`, `DropZoneSchema`, `DropEffectSchema` | 🟡 Partial — `useKanbanDragDrop` exists, full DnD protocol pending |
223+
| Gesture Protocol | `GestureConfigSchema`, `GestureTypeSchema`, `SwipeGestureConfigSchema`, `PinchGestureConfigSchema`, `LongPressGestureConfigSchema`, `TouchInteractionSchema`, `TouchTargetConfigSchema` | 🟡 Partial — swipe/haptics exist, spec-driven gesture config pending |
224+
| Offline/Sync Protocol | `OfflineConfigSchema`, `OfflineCacheConfigSchema`, `OfflineStrategySchema`, `SyncConfigSchema`, `ConflictResolutionSchema`, `PersistStorageSchema`, `EvictionPolicySchema` | 🟡 Partial — offline hooks exist, spec-driven config pending |
225+
| Notification UI Protocol | `NotificationSchema`, `NotificationConfigSchema`, `NotificationActionSchema`, `NotificationPositionSchema`, `NotificationSeveritySchema`, `NotificationTypeSchema` | 🟡 Partial — notifications exist, SDUI notification rendering pending |
226+
| Animation/Transition Protocol | `AnimationSchema`, `AnimationTriggerSchema`, `ComponentAnimationSchema`, `TransitionConfigSchema`, `TransitionPresetSchema`, `MotionConfigSchema`, `EasingFunctionSchema`, `PageTransitionSchema` | 🟡 Partial — micro-interactions exist, spec-driven animations pending |
227+
| Focus/Keyboard Protocol | `FocusManagementSchema`, `FocusTrapConfigSchema`, `KeyboardNavigationConfigSchema`, `KeyboardShortcutSchema` | 🔴 New — external keyboard/focus management not yet implemented |
228+
| Embed/Sharing Protocol | `EmbedConfigSchema`, `SharingConfigSchema`, `ViewSharingSchema` | 🟡 Partial — `useSharing` exists, embed/view sharing UI pending |
229+
| Interface Page Protocol | `InterfacePageConfigSchema`, `BlankPageLayoutSchema`, `BlankPageLayoutItemSchema`, `PageTypeSchema` | 🟡 Partial — `PageRenderer` exists, interface page config pending |
218230

219231
---
220232

@@ -245,7 +257,7 @@ All spec modules have been implemented, including previously deferred AI DevOps/
245257
## 5. Phase 11: AI & Intelligence ✅
246258

247259
> **Duration**: 3–4 weeks
248-
> v3.0.0 expanded AI module from ~100 to 187 exports.
260+
> v3.0.9 expanded AI module to 186 schemas / 188 exports.
249261
250262
### 11.1 Conversation Session Persistence ✅
251263

@@ -280,7 +292,7 @@ All spec modules have been implemented, including previously deferred AI DevOps/
280292

281293
## 6. Phase 12: Security Module ✅
282294

283-
> 🆕 v3.0.0 `security` module (26 exports) replaces `auth`/`permission`/`hub`.
295+
> 🆕 v3.0.9 `security` module (26 exports, 19 schemas) replaces `auth`/`permission`/`hub`.
284296
> **Duration**: 2–3 weeks
285297
286298
### 12.1 RLS Awareness ✅
@@ -599,6 +611,55 @@ All spec modules have been implemented, including previously deferred AI DevOps/
599611

600612
---
601613

614+
## 7m. v1.7: Spec v3.0.9 UI Protocol Alignment 🔴
615+
616+
> **Duration**: 4–6 weeks | **Priority**: 🟡 Important for spec compliance
617+
> **Goal**: Implement new UI protocol schemas from `@objectstack/spec@3.0.9` for full SDUI compliance
618+
619+
### Phase 23: SDUI Record Page Protocol 🔴
620+
621+
> Align record detail/form views with spec v3.0.9 `RecordDetailsProps`, `RecordHighlightsProps`, etc.
622+
623+
| # | Feature | Description | Status |
624+
|---|---------|-------------|--------|
625+
| 23.1 | Record Details SDUI | Render record detail layout from `RecordDetailsProps` (columns, sections, field list) | 🔴 Planned |
626+
| 23.2 | Record Highlights | Show highlight fields panel from `RecordHighlightsProps` | 🔴 Planned |
627+
| 23.3 | Record Activity Feed | Render activity timeline from `RecordActivityProps` | 🔴 Planned |
628+
| 23.4 | Record Chatter | In-context discussion from `RecordChatterProps` | 🔴 Planned |
629+
| 23.5 | Record Path / Breadcrumb | Navigation breadcrumb from `RecordPathProps` | 🔴 Planned |
630+
| 23.6 | Record Related Lists | Related record panels from `RecordRelatedListProps` | 🔴 Planned |
631+
| 23.7 | Record Review Config | Approval/review UI from `RecordReviewConfigSchema` | 🔴 Planned |
632+
| 23.8 | Interface Page Config | Airtable-style interface pages from `InterfacePageConfigSchema` | 🔴 Planned |
633+
| 23.9 | Blank Page Layouts | Custom blank page templates from `BlankPageLayoutSchema` | 🔴 Planned |
634+
635+
### Phase 24: Interaction Protocol (DnD, Gesture, Animation) 🔴
636+
637+
> Implement spec-driven interaction configs instead of hardcoded behavior.
638+
639+
| # | Feature | Description | Status |
640+
|---|---------|-------------|--------|
641+
| 24.1 | DnD Protocol | Spec-driven drag-and-drop from `DndConfigSchema` (drag items, drop zones, constraints, sortable) | 🔴 Planned |
642+
| 24.2 | Gesture Protocol | Configure gestures from `GestureConfigSchema` (swipe, pinch, long-press, touch targets) | 🔴 Planned |
643+
| 24.3 | Animation Protocol | Spec-driven animations from `AnimationSchema`, `TransitionConfigSchema`, `MotionConfigSchema` | 🔴 Planned |
644+
| 24.4 | Page Transition Protocol | Server-defined page transitions from `PageTransitionSchema`, `TransitionPresetSchema` | 🔴 Planned |
645+
| 24.5 | Component Animation | Per-component animation config from `ComponentAnimationSchema`, `EasingFunctionSchema` | 🔴 Planned |
646+
647+
### Phase 25: Focus, Keyboard, Offline & Notification Protocol 🔴
648+
649+
> Complete spec-driven configuration for accessibility, offline, and notification UI.
650+
651+
| # | Feature | Description | Status |
652+
|---|---------|-------------|--------|
653+
| 25.1 | Focus Management | Spec-driven focus traps and management from `FocusManagementSchema`, `FocusTrapConfigSchema` | 🔴 Planned |
654+
| 25.2 | Keyboard Navigation | External keyboard support from `KeyboardNavigationConfigSchema`, `KeyboardShortcutSchema` | 🔴 Planned |
655+
| 25.3 | Offline Config Protocol | Server-driven offline strategy from `OfflineConfigSchema`, `OfflineCacheConfigSchema`, `EvictionPolicySchema` | 🔴 Planned |
656+
| 25.4 | Sync Config Protocol | Spec-driven sync behavior from `SyncConfigSchema`, `ConflictResolutionSchema`, `PersistStorageSchema` | 🔴 Planned |
657+
| 25.5 | Notification UI Protocol | SDUI notification rendering from `NotificationSchema`, `NotificationConfigSchema`, `NotificationActionSchema` | 🔴 Planned |
658+
| 25.6 | Embed Config | Embeddable views from `EmbedConfigSchema` | 🔴 Planned |
659+
| 25.7 | View Sharing Protocol | Spec-driven view sharing from `ViewSharingSchema`, `SharingConfigSchema` | 🔴 Planned |
660+
661+
---
662+
602663
## 8. UX Design Review Summary
603664

604665
> Full UX design review: **[docs/UX-DESIGN-REVIEW.md](./docs/UX-DESIGN-REVIEW.md)**
@@ -738,6 +799,7 @@ All spec modules have been implemented, including previously deferred AI DevOps/
738799
| **v1.4** | 21–22 | Notification Center + Spec gaps (AI DevOps/CodeGen/Predictive, ETL/Connectors) | ✅ Complete |
739800
| **v1.5** | — | Messaging & Channels (Slack/Teams pattern, DMs, threads) | ✅ Complete |
740801
| **v1.6** | — | Advanced Offline (selective sync, three-way merge, offline analytics) | ✅ Complete |
802+
| **v1.7** | 23–25 | Spec v3.0.9 UI Protocol (SDUI record pages, DnD protocol, gesture/animation protocol, focus/keyboard) | 🔴 Planned |
741803

742804
---
743805

@@ -774,8 +836,12 @@ All spec modules have been implemented, including previously deferred AI DevOps/
774836
| **Notification Center (v1.4)** | **No** | **1 week** | **✅ Done** |
775837
| **Messaging & Channels (v1.5)** | **No** | **2 weeks** | **✅ Done** |
776838
| **Advanced Offline (v1.6)** | **No** | **2 weeks** | **✅ Done** |
839+
| **SDUI Record Page Protocol (23)** | **No** | **2–3 weeks** | **🔴 Planned** |
840+
| **Interaction Protocol — DnD/Gesture/Animation (24)** | **No** | **2–3 weeks** | **🔴 Planned** |
841+
| **Focus/Keyboard/Offline/Notification Protocol (25)** | **No** | **1–2 weeks** | **🔴 Planned** |
777842

778843
**Phase 11–22 + v1.4–v1.6**: ✅ Complete
844+
**Phase 23–25 (v1.7 — Spec v3.0.9 UI Protocol)**: 🔴 Planned
779845

780846
---
781847

@@ -815,6 +881,14 @@ All spec modules have been implemented, including previously deferred AI DevOps/
815881

816882
1. ✅ Phase 20 complete (design tokens, widget kit, voice, deep links, watch)
817883

884+
### v1.7 (Spec v3.0.9 UI Protocol)
885+
886+
1. ☐ Phase 23 complete (SDUI record pages, highlights, chatter, related lists, interface pages)
887+
2. ☐ Phase 24 complete (spec-driven DnD, gesture, animation, transition protocols)
888+
3. ☐ Phase 25 complete (focus management, keyboard navigation, offline/sync/notification UI protocols)
889+
4. ☐ All renderers consume spec UI schemas instead of hardcoded configs
890+
5. ☐ Full compliance with `@objectstack/spec@3.0.9` UI module (168 exports)
891+
818892
---
819893

820894
## 11. For SDK Team — Suggested Upstream Hooks
@@ -857,4 +931,4 @@ All spec modules have been implemented, including previously deferred AI DevOps/
857931

858932
---
859933

860-
*Last updated: 2026-02-13*
934+
*Last updated: 2026-02-22*

‎package.json‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,8 @@
2626
},
2727
"dependencies": {
2828
"@better-auth/expo": "^1.4.18",
29-
"@objectstack/client": "^3.0.0",
30-
"@objectstack/client-react": "^3.0.0",
29+
"@objectstack/client": "^3.0.9",
30+
"@objectstack/client-react": "^3.0.9",
3131
"@sentry/react-native": "^7.12.0",
3232
"@shopify/flash-list": "^2.2.2",
3333
"@tanstack/react-query": "^5.90.20",
@@ -78,11 +78,11 @@
7878
"@babel/core": "^7.29.0",
7979
"@changesets/changelog-github": "^0.5.2",
8080
"@changesets/cli": "^2.29.8",
81-
"@objectstack/core": "^3.0.0",
82-
"@objectstack/driver-memory": "^3.0.0",
83-
"@objectstack/objectql": "^3.0.0",
84-
"@objectstack/plugin-auth": "^3.0.0",
85-
"@objectstack/plugin-hono-server": "^3.0.0",
81+
"@objectstack/core": "^3.0.9",
82+
"@objectstack/driver-memory": "^3.0.9",
83+
"@objectstack/objectql": "^3.0.9",
84+
"@objectstack/plugin-auth": "^3.0.9",
85+
"@objectstack/plugin-hono-server": "^3.0.9",
8686
"@testing-library/jest-native": "^5.4.3",
8787
"@testing-library/react-native": "^12.9.0",
8888
"@types/jest": "^29.5.14",

0 commit comments

Comments
 (0)